MediaStore
Defined in: gadgets/media-store.ts:87
Session-scoped media storage with ID abstraction.
Each MediaStore instance manages media for a single agent session. Media files are stored in a temporary directory and referenced by short, unique IDs rather than file paths.
Constructors
Section titled “Constructors”Constructor
Section titled “Constructor”new MediaStore(
sessionId?):MediaStore
Defined in: gadgets/media-store.ts:99
Create a new MediaStore.
Parameters
Section titled “Parameters”sessionId?
Section titled “sessionId?”string
Optional session ID for the output directory. If not provided, a random ID is generated.
Returns
Section titled “Returns”MediaStore
Accessors
Section titled “Accessors”Get Signature
Section titled “Get Signature”get size():
number
Defined in: gadgets/media-store.ts:232
Get the count of stored media items.
Returns
Section titled “Returns”number
Methods
Section titled “Methods”cleanup()
Section titled “cleanup()”cleanup():
Promise<void>
Defined in: gadgets/media-store.ts:256
Delete all stored files and clear memory. Removes the entire session directory.
Returns
Section titled “Returns”Promise<void>
clear()
Section titled “clear()”clear():
void
Defined in: gadgets/media-store.ts:247
Clear in-memory store without deleting files. Resets the counter but leaves files on disk.
Returns
Section titled “Returns”void
get(
id):StoredMedia|undefined
Defined in: gadgets/media-store.ts:200
Get stored media by ID.
Parameters
Section titled “Parameters”string
The media ID (e.g., “media_a1b2c3”)
Returns
Section titled “Returns”StoredMedia | undefined
The stored media or undefined if not found
getOutputDir()
Section titled “getOutputDir()”getOutputDir():
string
Defined in: gadgets/media-store.ts:107
Get the output directory path.
Returns
Section titled “Returns”string
getPath()
Section titled “getPath()”getPath(
id):string|undefined
Defined in: gadgets/media-store.ts:211
Get the actual file path for a media ID. Convenience method for gadgets that need the raw path.
Parameters
Section titled “Parameters”string
The media ID
Returns
Section titled “Returns”string | undefined
The file path or undefined if not found
has(
id):boolean
Defined in: gadgets/media-store.ts:239
Check if a media ID exists.
Parameters
Section titled “Parameters”string
Returns
Section titled “Returns”boolean
list()
Section titled “list()”list(
kind?):StoredMedia[]
Defined in: gadgets/media-store.ts:221
List all stored media, optionally filtered by kind.
Parameters
Section titled “Parameters”Optional media kind to filter by
Returns
Section titled “Returns”Array of stored media items
store()
Section titled “store()”store(
media,gadgetName):Promise<StoredMedia>
Defined in: gadgets/media-store.ts:157
Store media and return stored metadata with ID.
Parameters
Section titled “Parameters”The media output from a gadget
gadgetName
Section titled “gadgetName”string
Name of the gadget that created this media
Returns
Section titled “Returns”Promise<StoredMedia>
Stored media information including generated ID
Throws
Section titled “Throws”Error if file write fails