Workflow state

export declare function approxByteSize(value: unknown): number;

export declare const ARTIFACT_POINTER_PREFIX = "art:";

export interface ArtifactPointer {
    pointer: string;
    preview: string;
    sizeBytes: number;
    name?: string;
}

/**
 * Returns the pair of tools an Agent uses to interact with the Memory Pointer
 * artifact store: `storeArtifact` and `getArtifact`.
 *
 * Both tools share the same `RunContext.sessionState`, so an artifact stored on
 * one turn is retrievable on later turns within the same session.
 */
export declare function createArtifactTools(): ToolDef[];

/** Look up an artifact by its pointer (`art:...`) or by its caller-supplied name. */
export declare function getArtifact(ctx: RunContext, pointerOrName: string): StoredArtifact | null;

/** Convert a pointer string back to its raw artifact. Returns `null` if not found. */
export declare function isPointer(s: unknown): s is string;

/** List all artifacts stored in the current run/session. */
export declare function listArtifacts(ctx: RunContext): StoredArtifact[];

/** Store an artifact and return its pointer + preview. */
export declare function storeArtifact(ctx: RunContext, value: unknown, opts?: {
    name?: string;
    contentType?: string;
    previewChars?: number;
}): ArtifactPointer;

export interface StoredArtifact {
    id: string;
    /** Optional caller-supplied name for human-readable retrieval. */
    name?: string;
    /** The actual stored value. */
    value: unknown;
    /** Short text preview used in pointer responses. */
    preview: string;
    /** Approximate size of the original serialized value in bytes. */
    sizeBytes: number;
    /** When the artifact was stored. */
    storedAt: number;
    /** Mime type or content type hint. */
    contentType?: string;
}