donobu 1.0.0

package/dist/models/FlowMetadata.d.ts

@@ -0,0 +1,123 @@
+import { CustomTool } from './CustomTool';
+import { BrowserStateFlowReference } from './BrowserStateFlowReference';
+import { JSONSchema7 } from 'json-schema';
+/**
+ * Metadata type of the details/status/state of a Donobu flow.
+ */
+export type FlowMetadata = {
+    /** The unique ID of this flow. */
+    readonly id: string;
+    /** The name of this flow. */
+    readonly name: string | null;
+    /** The version of Donobu that created the flow. */
+    readonly createdWithDonobuVersion: string;
+    /** The source of the initial browser state. */
+    readonly initialBrowserState: BrowserStateFlowReference | null;
+    /** If true, will persist the final browser state when the flow completes. */
+    readonly persistBrowserState: boolean | null;
+    /** The name of the specific GPT configuration used for the flow. */
+    readonly gptConfigName: string | null;
+    /**
+     * If true, means that the `gptConfigName` was explicitly overwritten when the
+     * flow was created.
+     **/
+    readonly hasGptConfigNameOverride: boolean;
+    /** Custom tools available for the flow. */
+    readonly customTools: CustomTool[] | null;
+    /** The default amount of time a tool tip should show. */
+    readonly defaultToolTipDurationMilliseconds: number | null;
+    /** The run mode of the flow. */
+    runMode: RunMode;
+    /** Set to true if the in-browser control panel should be enabled. */
+    isControlPanelEnabled: boolean;
+    /**
+     * The name of the device to use for the flow.
+     * If non-null, remoteBrowserInstanceUrl must be null
+     */
+    readonly deviceName: string | null;
+    /**
+     * The URL of a remote browser instance to connect to using Chrome DevTools Protocol (CDP).
+     * If non-null, deviceName must be null. URLs containing "${env.VARIABLE_NAME}" will be
+     * expanded to the value of the specified environment variable.
+     */
+    readonly remoteBrowserInstanceUrl: string | null;
+    /**
+     * The URL to HTTP POST to when the flow completes. The
+     * body will contain a JSON object with single field, "id", of which is
+     * the ID of the flow that completed.
+     */
+    readonly callbackUrl: string | null;
+    /** If true, a real browser window was not used to perform the flow. */
+    readonly headless: boolean;
+    /** The website URL to start the flow at. */
+    readonly targetWebsite: string;
+    /** The overall objective to pursue. */
+    readonly overallObjective: string | null;
+    /** The set of allowed tools (by Tool.name()) for this flow. */
+    readonly allowedTools: string[];
+    /** If non-null, the JSON schema that the result field will conform to. */
+    readonly resultJsonSchema: JSONSchema7 | null;
+    /**
+     * The result of the flow. If terminated successfully and resultJsonSchema is non-null,
+     * this field will conform to resultJsonSchema. Otherwise, matches the value of the last
+     * tool call's ToolCallResult.metadata.
+     */
+    result: Record<string, unknown> | null;
+    /** The number of LLM input tokens used during this flow. */
+    inputTokensUsed: number;
+    /** The number of LLM completion tokens used during this flow. */
+    completionTokensUsed: number;
+    /** Number of overall iterations done (LLM calls made or simulated in replay). */
+    iterations: number;
+    /** The maximum number of iterations allowed for this flow. */
+    readonly maxIterations: number;
+    /** The Unix epoch millisecond timestamp of when the flow started. */
+    startedAt: number | null;
+    /** The Unix epoch millisecond timestamp of when the flow completed. */
+    completedAt: number | null;
+    /** The current state of the flow. */
+    state: State;
+    /** The planned next state of the flow. */
+    nextState: State | null;
+};
+/**
+ * Represents the possible states of a flow.
+ */
+export declare enum State {
+    UNSTARTED = "UNSTARTED",
+    INITIALIZING = "INITIALIZING",
+    QUERYING_LLM_FOR_NEXT_ACTION = "QUERYING_LLM_FOR_NEXT_ACTION",
+    WAITING_ON_USER_FOR_NEXT_ACTION = "WAITING_ON_USER_FOR_NEXT_ACTION",
+    PAUSED = "PAUSED",
+    RESUMING = "RESUMING",
+    RUNNING_ACTION = "RUNNING_ACTION",
+    FAILED = "FAILED",
+    SUCCESS = "SUCCESS"
+}
+/**
+ * Checks if a flow state represents completion (either success or failure).
+ *
+ * @param state - The state to check
+ * @returns True if the state represents completion
+ */
+export declare const isComplete: (state: State) => boolean;
+/**
+ * Represents the possible run modes for a flow.
+ */
+export declare enum RunMode {
+    /**
+     * The flow is being directed by a non-human agent. The flow ends when the
+     * agent decides to end it, or if explicitly directed to end the flow.
+     */
+    AUTONOMOUS = "AUTONOMOUS",
+    /**
+     * The flow is being directed by a human agent. The flow only ends when
+     * the human agent decides to end it.
+     */
+    INSTRUCT = "INSTRUCT",
+    /**
+     * The flow is on rails and has no agent. Once all tool calls have been run,
+     * the flow will be automatically marked as complete.
+     */
+    DETERMINISTIC = "DETERMINISTIC"
+}

package/dist/models/FlowMetadata.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunMode = exports.isComplete = exports.State = void 0;
+/**
+ * Represents the possible states of a flow.
+ */
+var State;
+(function (State) {
+    State["UNSTARTED"] = "UNSTARTED";
+    State["INITIALIZING"] = "INITIALIZING";
+    State["QUERYING_LLM_FOR_NEXT_ACTION"] = "QUERYING_LLM_FOR_NEXT_ACTION";
+    State["WAITING_ON_USER_FOR_NEXT_ACTION"] = "WAITING_ON_USER_FOR_NEXT_ACTION";
+    State["PAUSED"] = "PAUSED";
+    State["RESUMING"] = "RESUMING";
+    State["RUNNING_ACTION"] = "RUNNING_ACTION";
+    State["FAILED"] = "FAILED";
+    State["SUCCESS"] = "SUCCESS";
+})(State || (exports.State = State = {}));
+/**
+ * Checks if a flow state represents completion (either success or failure).
+ *
+ * @param state - The state to check
+ * @returns True if the state represents completion
+ */
+const isComplete = (state) => {
+    return state === State.FAILED || state === State.SUCCESS;
+};
+exports.isComplete = isComplete;
+/**
+ * Represents the possible run modes for a flow.
+ */
+var RunMode;
+(function (RunMode) {
+    /**
+     * The flow is being directed by a non-human agent. The flow ends when the
+     * agent decides to end it, or if explicitly directed to end the flow.
+     */
+    RunMode["AUTONOMOUS"] = "AUTONOMOUS";
+    /**
+     * The flow is being directed by a human agent. The flow only ends when
+     * the human agent decides to end it.
+     */
+    RunMode["INSTRUCT"] = "INSTRUCT";
+    /**
+     * The flow is on rails and has no agent. Once all tool calls have been run,
+     * the flow will be automatically marked as complete.
+     */
+    RunMode["DETERMINISTIC"] = "DETERMINISTIC";
+})(RunMode || (exports.RunMode = RunMode = {}));
+//# sourceMappingURL=FlowMetadata.js.map

package/dist/models/FlowMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowMetadata.js","sourceRoot":"","sources":["../../src/models/FlowMetadata.ts"],"names":[],"mappings":";;;AA+GA;;GAEG;AACH,IAAY,KAUX;AAVD,WAAY,KAAK;IACf,gCAAuB,CAAA;IACvB,sCAA6B,CAAA;IAC7B,sEAA6D,CAAA;IAC7D,4EAAmE,CAAA;IACnE,0BAAiB,CAAA;IACjB,8BAAqB,CAAA;IACrB,0CAAiC,CAAA;IACjC,0BAAiB,CAAA;IACjB,4BAAmB,CAAA;AACrB,CAAC,EAVW,KAAK,qBAAL,KAAK,QAUhB;AAED;;;;;GAKG;AACI,MAAM,UAAU,GAAG,CAAC,KAAY,EAAW,EAAE;IAClD,OAAO,KAAK,KAAK,KAAK,CAAC,MAAM,IAAI,KAAK,KAAK,KAAK,CAAC,OAAO,CAAC;AAC3D,CAAC,CAAC;AAFW,QAAA,UAAU,cAErB;AAEF;;GAEG;AACH,IAAY,OAgBX;AAhBD,WAAY,OAAO;IACjB;;;OAGG;IACH,oCAAyB,CAAA;IACzB;;;OAGG;IACH,gCAAqB,CAAA;IACrB;;;OAGG;IACH,0CAA+B,CAAA;AACjC,CAAC,EAhBW,OAAO,uBAAP,OAAO,QAgBlB"}

package/dist/models/FlowsQuery.d.ts

@@ -0,0 +1,11 @@
+import { RunMode } from './FlowMetadata';
+import { State } from './FlowMetadata';
+export type FlowsQuery = {
+    name?: string;
+    startedAfter?: number;
+    startedBefore?: number;
+    runMode?: RunMode;
+    state?: State;
+    limit?: number;
+    pageToken?: string;
+};

package/dist/models/FlowsQuery.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=FlowsQuery.js.map

package/dist/models/FlowsQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowsQuery.js","sourceRoot":"","sources":["../../src/models/FlowsQuery.ts"],"names":[],"mappings":""}

package/dist/models/FocusedPage.d.ts

@@ -0,0 +1,4 @@
+import { Page } from 'playwright';
+export type FocusedPage = {
+    current: Page | null;
+};

package/dist/models/FocusedPage.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=FocusedPage.js.map

package/dist/models/FocusedPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FocusedPage.js","sourceRoot":"","sources":["../../src/models/FocusedPage.ts"],"names":[],"mappings":""}

package/dist/models/GptConfig.d.ts

@@ -0,0 +1,38 @@
+export type AnthropicConfig = {
+    type: 'ANTHROPIC';
+    apiKey: string;
+    modelName: string;
+};
+export type AnthropicAwsBedrockConfig = {
+    type: 'ANTHROPIC_AWS_BEDROCK';
+    region: string;
+    modelName: string;
+    accessKeyId?: string;
+    secretAccessKey?: string;
+};
+export type GoogleGeminiConfig = {
+    type: 'GOOGLE_GEMINI';
+    apiKey: string;
+    modelName: string;
+};
+export type OpenApiConfig = {
+    type: 'OPENAI';
+    apiKey: string;
+    modelName: string;
+};
+export type OpenApiAzureConfig = {
+    type: 'OPENAI_AZURE';
+};
+export type LlamaLocalConfig = {
+    type: 'LLAMA_LOCAL';
+};
+export type LlamaHuggingFaceConfig = {
+    type: 'LLAMA_HUGGING_FACE';
+};
+/**
+ * A resource structure that can be used to establish connectivity with a
+ * particular GPT platform and model. If there are an 'apiKey', and/or a
+ * `secretAccessKey` fields, they will be redacted before being returned
+ * through the API.
+ */
+export type GptConfig = AnthropicConfig | AnthropicAwsBedrockConfig | GoogleGeminiConfig | OpenApiConfig | OpenApiAzureConfig | LlamaLocalConfig | LlamaHuggingFaceConfig;

package/dist/models/GptConfig.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=GptConfig.js.map

package/dist/models/GptConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GptConfig.js","sourceRoot":"","sources":["../../src/models/GptConfig.ts"],"names":[],"mappings":""}

package/dist/models/GptMessage.d.ts

@@ -0,0 +1,43 @@
+import { ProposedToolCall } from './ProposedToolCall';
+export type AssistantMessage = {
+    type: 'assistant';
+    text: string;
+    promptTokensUsed: number;
+    completionTokensUsed: number;
+};
+export type StructuredOutputMessage = {
+    type: 'structured_output';
+    output: Record<string, unknown>;
+    promptTokensUsed: number;
+    completionTokensUsed: number;
+};
+export type ProposedToolCallsMessage = {
+    type: 'proposed_tool_calls';
+    proposedToolCalls: ProposedToolCall<Record<string, unknown>>[];
+    promptTokensUsed: number;
+    completionTokensUsed: number;
+};
+export type SystemMessage = {
+    type: 'system';
+    text: string;
+};
+export type ToolCallResultMessage = {
+    type: 'tool_call_result';
+    toolName: string;
+    data: string;
+    toolCallId: string;
+};
+export type PngItem = {
+    type: 'png';
+    bytes: Uint8Array;
+};
+export type TextItem = {
+    type: 'text';
+    text: string;
+};
+export type UserMessageItem = PngItem | TextItem;
+export type UserMessage = {
+    type: 'user';
+    items: UserMessageItem[];
+};
+export type GptMessage = AssistantMessage | StructuredOutputMessage | ProposedToolCallsMessage | SystemMessage | ToolCallResultMessage | UserMessage;

package/dist/models/GptMessage.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=GptMessage.js.map

package/dist/models/GptMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GptMessage.js","sourceRoot":"","sources":["../../src/models/GptMessage.ts"],"names":[],"mappings":""}

package/dist/models/GptResource.d.ts

@@ -0,0 +1,33 @@
+export type AnthropicConfig = {
+    type: 'ANTHROPIC';
+    apiKey: string;
+    modelName: string;
+};
+export type AnthropicAwsBedrockConfig = {
+    type: 'ANTHROPIC_AWS_BEDROCK';
+};
+export type GoogleGeminiConfig = {
+    type: 'GOOGLE_GEMINI';
+    apiKey: string;
+    modelName: string;
+};
+export type OpenApiConfig = {
+    type: 'OPENAI';
+    apiKey: string;
+    modelName: string;
+};
+export type OpenApiAzureConfig = {
+    type: 'OPENAI_AZURE';
+};
+export type LlamaLocalConfig = {
+    type: 'LLAMA_LOCAL';
+};
+export type LlamaHuggingFaceConfig = {
+    type: 'LLAMA_HUGGING_FACE';
+};
+/**
+ * A resource structure that can be used to establish connectivity with a
+ * particular GPT platform and model. If there is an 'apiKey' field, it will be
+ * redacted before being returned through the API.
+ */
+export type GptResource = AnthropicConfig | AnthropicAwsBedrockConfig | GoogleGeminiConfig | OpenApiConfig | OpenApiAzureConfig | LlamaLocalConfig | LlamaHuggingFaceConfig;

package/dist/models/GptResource.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=GptResource.js.map

package/dist/models/GptResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GptResource.js","sourceRoot":"","sources":["../../src/models/GptResource.ts"],"names":[],"mappings":""}

package/dist/models/InteractableElement.d.ts

@@ -0,0 +1,13 @@
+/**
+ * A handle to an HTML element that has a DONOBU_INTERACTABLE_ATTRIBUTE HTML attribute.
+ */
+export type InteractableElement = {
+    /**
+     * The value for this element's DONOBU_INTERACTABLE_ATTRIBUTE.
+     */
+    readonly donobuAttributeValue: string;
+    /**
+     * A short HTML snippet of the element.
+     */
+    readonly htmlSnippet: string;
+};

package/dist/models/InteractableElement.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=InteractableElement.js.map

package/dist/models/InteractableElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractableElement.js","sourceRoot":"","sources":["../../src/models/InteractableElement.ts"],"names":[],"mappings":""}

package/dist/models/ProposedToolCall.d.ts

@@ -0,0 +1,19 @@
+/**
+ * A proposed (i.e. yet to be executed) tool call.
+ */
+export type ProposedToolCall<T> = {
+    /**
+     * The name of the tool to call.
+     */
+    readonly name: string;
+    /**
+     * The parameters to supply to the tool's call method.
+     * Must conform to the tool's expected parameters type.
+     */
+    readonly parameters: T;
+    /**
+     * The ID used by the GPT model to track a proposed tool call to tool a call result.
+     * This maps to the toolCallId in ToolCallResultMessage.
+     */
+    readonly toolCallId?: string | null;
+};

package/dist/models/ProposedToolCall.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ProposedToolCall.js.map

package/dist/models/ProposedToolCall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProposedToolCall.js","sourceRoot":"","sources":["../../src/models/ProposedToolCall.ts"],"names":[],"mappings":""}

package/dist/models/RequestContext.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The API request context. Highly sensitive since it handles Supabase API tokens.
+ */
+export declare class RequestContext {
+    /**
+     * The Supabase access token associated with this request. May be null if the
+     * request is unauthenticated. This value can be trusted since even if someone hacks the
+     * code, they will not be able to fake a valid value for this token since it is
+     * authenticated by Supabase when performing requests with Supabase.
+     */
+    readonly accessToken: string | null;
+    constructor(
+    /**
+     * The Supabase access token associated with this request. May be null if the
+     * request is unauthenticated. This value can be trusted since even if someone hacks the
+     * code, they will not be able to fake a valid value for this token since it is
+     * authenticated by Supabase when performing requests with Supabase.
+     */
+    accessToken: string | null);
+    toString(): string;
+}

package/dist/models/RequestContext.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestContext = void 0;
+/**
+ * The API request context. Highly sensitive since it handles Supabase API tokens.
+ */
+class RequestContext {
+    accessToken;
+    constructor(
+    /**
+     * The Supabase access token associated with this request. May be null if the
+     * request is unauthenticated. This value can be trusted since even if someone hacks the
+     * code, they will not be able to fake a valid value for this token since it is
+     * authenticated by Supabase when performing requests with Supabase.
+     */
+    accessToken) {
+        this.accessToken = accessToken;
+    }
+    toString() {
+        return 'RequestContext[accessToken=*****]';
+    }
+}
+exports.RequestContext = RequestContext;
+//# sourceMappingURL=RequestContext.js.map

package/dist/models/RequestContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestContext.js","sourceRoot":"","sources":["../../src/models/RequestContext.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,cAAc;IAQP;IAPlB;IACE;;;;;OAKG;IACa,WAA0B;QAA1B,gBAAW,GAAX,WAAW,CAAe;IACzC,CAAC;IAEJ,QAAQ;QACN,OAAO,mCAAmC,CAAC;IAC7C,CAAC;CACF;AAdD,wCAcC"}

package/dist/models/ToolCall.d.ts

@@ -0,0 +1,38 @@
+import { ToolCallResult } from './ToolCallResult';
+/**
+ * The record for a singular call for a tool. This is used for persistence and APIs.
+ */
+export type ToolCall = {
+    /**
+     * The ID for this singular call.
+     */
+    readonly id: string;
+    /**
+     * The tool name of the tool called.
+     */
+    readonly toolName: string;
+    /**
+     * The parameters supplied to the tool.
+     */
+    readonly parameters: any;
+    /**
+     * The result of the tool call.
+     */
+    readonly outcome: ToolCallResult;
+    /**
+     * The ID of the image of the page after the tool was called.
+     */
+    readonly postCallImageId: string;
+    /**
+     * The URL of the webpage that the tool had focus on when running.
+     */
+    readonly page: string;
+    /**
+     * The Unix epoch millisecond timestamp of the instant the tool was called.
+     */
+    readonly startedAt: number;
+    /**
+     * The Unix epoch millisecond timestamp of the instant the tool completed.
+     */
+    readonly completedAt: number;
+};

package/dist/models/ToolCall.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ToolCall.js.map

package/dist/models/ToolCall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolCall.js","sourceRoot":"","sources":["../../src/models/ToolCall.ts"],"names":[],"mappings":""}

package/dist/models/ToolCallContext.d.ts

@@ -0,0 +1,22 @@
+import { Page } from 'playwright';
+import { GptClient } from '../clients/GptClient';
+import { FlowMetadata } from './FlowMetadata';
+import { ProposedToolCall } from './ProposedToolCall';
+import { ToolCall } from './ToolCall';
+import { ToolTipper } from '../managers/ToolTipper';
+import { FlowsPersistence } from '../persistence/FlowsPersistence';
+import { DonobuFlowsManager } from '../managers/DonobuFlowsManager';
+/**
+ * This is supplied as context when invoking a tool.
+ */
+export type ToolCallContext = {
+    readonly flowsManager: DonobuFlowsManager;
+    readonly persistence: FlowsPersistence;
+    readonly gptClient: GptClient | null;
+    readonly toolTipper: ToolTipper;
+    readonly proposedToolCalls: ProposedToolCall<any>[];
+    readonly invokedToolCalls: ToolCall[];
+    page: Page;
+    readonly metadata: FlowMetadata;
+    readonly toolCallId: string;
+};

package/dist/models/ToolCallContext.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ToolCallContext.js.map

package/dist/models/ToolCallContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolCallContext.js","sourceRoot":"","sources":["../../src/models/ToolCallContext.ts"],"names":[],"mappings":""}

package/dist/models/ToolCallResult.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Response wrapper object for a tool call.
+ */
+export type ToolCallResult = {
+    /** Indicates if the tool call should be considered a success */
+    readonly isSuccessful: boolean;
+    /** The data to return back to the LLM so that it knows the outcome of this tool call */
+    readonly forLlm: string;
+    /** Metadata to record, but will not be shared with the LLM */
+    readonly metadata: Record<string, unknown> | null;
+};
+/**
+ * Factory functions for creating ToolCallResult objects
+ */
+export declare const ToolCallResult: {
+    /**
+     * Creates a successful ToolCallResult.
+     */
+    successful(): ToolCallResult;
+};

package/dist/models/ToolCallResult.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolCallResult = void 0;
+/**
+ * Factory functions for creating ToolCallResult objects
+ */
+exports.ToolCallResult = {
+    /**
+     * Creates a successful ToolCallResult.
+     */
+    successful() {
+        return {
+            isSuccessful: true,
+            forLlm: 'SUCCESS',
+            metadata: null,
+        };
+    },
+};
+//# sourceMappingURL=ToolCallResult.js.map

package/dist/models/ToolCallResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolCallResult.js","sourceRoot":"","sources":["../../src/models/ToolCallResult.ts"],"names":[],"mappings":";;;AAcA;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B;;OAEG;IACH,UAAU;QACR,OAAO;YACL,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,IAAI;SACf,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/models/VideoSegment.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A single segment of a video. This structure helps enable HTTP handlers that need to retrieve
+ * different parts of a video using a `Range` header, rather than having to retrieve the
+ * entire video.
+ */
+export type VideoSegment = {
+    /**
+     * The raw bytes of the video segment in `webm` format.
+     */
+    readonly bytes: Buffer;
+    /**
+     * The total number of bytes for the entire video (which may be larger than this
+     * single video segment).
+     */
+    readonly totalLength: number;
+    /**
+     * The byte offset that this video segment begins at.
+     */
+    readonly startOffset: number;
+};

package/dist/models/VideoSegment.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=VideoSegment.js.map

package/dist/models/VideoSegment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoSegment.js","sourceRoot":"","sources":["../../src/models/VideoSegment.ts"],"names":[],"mappings":""}

package/dist/persistence/AgentsPersistence.d.ts

@@ -0,0 +1,11 @@
+import { DonobuAgent } from '../models/DonobuAgentType';
+/**
+ * Interface for persisting a mapping between a particular agent type and GPT
+ * configuration names. Implementation of this class can assume validation of
+ * mappings occurs at an upper layer.
+ */
+export interface AgentsPersistence {
+    set(agent: DonobuAgent, gptConfigName: string | null): Promise<void>;
+    get(agent: DonobuAgent): Promise<string | null>;
+    getAll(): Promise<Map<DonobuAgent, string | null>>;
+}

package/dist/persistence/AgentsPersistence.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=AgentsPersistence.js.map

package/dist/persistence/AgentsPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentsPersistence.js","sourceRoot":"","sources":["../../src/persistence/AgentsPersistence.ts"],"names":[],"mappings":""}

package/dist/persistence/AgentsPersistenceFilesystem.d.ts

@@ -0,0 +1,15 @@
+import { DonobuAgent } from '../models/DonobuAgentType';
+import { AgentsPersistence } from './AgentsPersistence';
+/**
+ * A GPT configs persistence implementation that manages state using a JSON
+ * file on the filesystem.
+ */
+export declare class AgentsPersistenceFilesystem implements AgentsPersistence {
+    private readonly storagePath;
+    private static readonly FILENAME;
+    private constructor();
+    static create(storageDirectory: string): Promise<AgentsPersistenceFilesystem>;
+    set(agent: DonobuAgent, gptConfigName: string | null): Promise<void>;
+    get(agent: DonobuAgent): Promise<string | null>;
+    getAll(): Promise<Map<DonobuAgent, string | null>>;
+}