@dxos/assistant-toolkit 0.8.4-main.1068cf700f

package/dist/types/src/functions/tasks/task-list.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Hierarchical Task List Manager.
+ *
+ * A framework for managing hierarchical task lists where each line is a task.
+ * Designed to work with language model agents that receive documents with line numbers.
+ */
+export declare class MarkdownTasks {
+    private _lineEndings;
+    private _content;
+    constructor(initialContent?: string);
+    /**
+     * Get the current document content with line numbers prefixed.
+     */
+    getNumberedContent(): string;
+    /**
+     * Get the raw document content without line numbers.
+     */
+    getRawContent(): string;
+    /**
+     * Insert a new task at the specified line number (1-based).
+     * Indentation level determines hierarchy (0, 2, 4, 6 spaces etc.)
+     */
+    insertTask(lineNumber: number, taskText: string, completed?: boolean, indent?: number): void;
+    /**
+     * Delete a task at the specified line number (1-based).
+     */
+    deleteTask(lineNumber: number): boolean;
+    /**
+     * Update the text of a task at the specified line number (1-based).
+     */
+    updateTaskText(lineNumber: number, newText: string): boolean;
+    /**
+     * Mark a task as complete or incomplete at the specified line number (1-based).
+     */
+    toggleTaskCompletion(lineNumber: number, completed?: boolean): boolean;
+    /**
+     * Change the indentation level of a task (for hierarchy).
+     */
+    setTaskIndent(lineNumber: number, indent: number): boolean;
+    /**
+     * Get the total number of lines in the document.
+     */
+    getLineCount(): number;
+    /**
+     * Apply multiple operations atomically.
+     */
+    applyOperations(operations: TaskOperation[]): void;
+}
+/**
+ * Operation types for batch task updates.
+ */
+export type TaskOperation = {
+    type: 'insertTask';
+    lineNumber: number;
+    text: string;
+    completed?: boolean;
+    indent?: number;
+} | {
+    type: 'deleteTask';
+    lineNumber: number;
+} | {
+    type: 'updateTaskText';
+    lineNumber: number;
+    text: string;
+} | {
+    type: 'toggleTaskCompletion';
+    lineNumber: number;
+    completed?: boolean;
+} | {
+    type: 'setTaskIndent';
+    lineNumber: number;
+    indent: number;
+};
+//# sourceMappingURL=task-list.d.ts.map

package/dist/types/src/functions/tasks/task-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-list.d.ts","sourceRoot":"","sources":["../../../../../src/functions/tasks/task-list.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAW;gBAEf,cAAc,GAAE,MAAW;IAMvC;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAM5B;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,OAAe,EAAE,MAAM,GAAE,MAAU,GAAG,IAAI;IAOtG;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAQvC;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAe5D;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO;IAkBtE;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAgB1D;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,IAAI;CA4BnD;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9F;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types/src/functions/tasks/task-list.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=task-list.test.d.ts.map

package/dist/types/src/functions/tasks/task-list.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-list.test.d.ts","sourceRoot":"","sources":["../../../../../src/functions/tasks/task-list.test.ts"],"names":[],"mappings":""}

package/dist/types/src/functions/tasks/update.d.ts

@@ -0,0 +1,16 @@
+declare const _default: import("@dxos/functions").FunctionDefinition<{
+    readonly doc: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+        readonly name?: string | undefined;
+        readonly description?: string | undefined;
+        readonly fallbackName?: string | undefined;
+        readonly content: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly content: string;
+        }>;
+    }>;
+    readonly operations?: readonly any[] | undefined;
+}, {
+    readonly content: string;
+    readonly numberedContent: string;
+}, import("@dxos/functions").FunctionServices>;
+export default _default;
+//# sourceMappingURL=update.d.ts.map

package/dist/types/src/functions/tasks/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../../src/functions/tasks/update.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAaA,wBAsCG"}

package/dist/types/src/index.d.ts

@@ -0,0 +1,9 @@
+export * from './blueprints';
+export * from './chat';
+export * from './crud';
+export * from './functions';
+export * as Initiative from './initiative';
+export * from './sync';
+export * from './toolkits';
+export * as Planning from './planning';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC"}

package/dist/types/src/initiative/Initiative.d.ts

@@ -0,0 +1,41 @@
+import * as Schema from 'effect/Schema';
+import { Type } from '@dxos/echo';
+import { Queue } from '@dxos/echo-db';
+/**
+ * Initiative schema definition.
+ */
+export declare const Initiative: Type.Obj<{
+    readonly name: string;
+    readonly queue?: import("@dxos/echo/internal").Ref<Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+    readonly chat?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+        readonly name?: string | undefined;
+        readonly queue: import("@dxos/echo/internal").Ref<Queue<import("@dxos/echo/Entity").Unknown>>;
+        readonly traceQueue?: import("@dxos/echo/internal").Ref<Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+    }> | undefined;
+    readonly spec: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+        readonly content: string;
+    }>;
+    readonly plan: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+        readonly tasks: readonly {
+            readonly title: string;
+            readonly id: string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">;
+            readonly status: "done" | "todo" | "in-progress";
+            readonly parent?: (string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">) | undefined;
+            readonly chat?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+                readonly name?: string | undefined;
+                readonly queue: import("@dxos/echo/internal").Ref<Queue<import("@dxos/echo/Entity").Unknown>>;
+                readonly traceQueue?: import("@dxos/echo/internal").Ref<Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+            }> | undefined;
+        }[];
+    }>;
+    readonly artifacts: readonly {
+        readonly name: string;
+        readonly data: import("@dxos/echo/internal").Ref<any>;
+    }[];
+    readonly subscriptions: readonly import("@dxos/echo/internal").Ref<any>[];
+    readonly useQualifyingAgent?: boolean | undefined;
+    readonly newChatOnEveryEvent?: boolean | undefined;
+}, Schema.Struct.Fields>;
+export interface Initiative extends Schema.Schema.Type<typeof Initiative> {
+}
+//# sourceMappingURL=Initiative.d.ts.map

package/dist/types/src/initiative/Initiative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Initiative.d.ts","sourceRoot":"","sources":["../../../../src/initiative/Initiative.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAOtC;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA0CtB,CAAC;AACF,MAAM,WAAW,UAAW,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC;CAAG"}

package/dist/types/src/initiative/blueprint.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Get all initiative functions. This is a function to avoid circular dependency issues.
+ */
+export declare const getFunctions: () => (import("@dxos/functions").FunctionDefinition<{}, {
+    readonly name: string;
+    readonly id: string;
+    readonly spec: string;
+    readonly plan: string;
+    readonly artifacts: readonly {
+        readonly name: string;
+        readonly type?: string | undefined;
+        readonly dxn?: string | undefined;
+    }[];
+}, import("@dxos/functions").FunctionServices> | import("@dxos/functions").FunctionDefinition<{
+    readonly name: string;
+    readonly artifact: import("@dxos/echo/internal").Ref<any>;
+}, void, import("@dxos/functions").FunctionServices> | import("@dxos/functions").FunctionDefinition<{
+    readonly prompt?: string | undefined;
+    readonly initiative: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+        readonly name: string;
+        readonly queue?: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+        readonly chat?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly name?: string | undefined;
+            readonly queue: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>>;
+            readonly traceQueue?: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+        }> | undefined;
+        readonly spec: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly content: string;
+        }>;
+        readonly plan: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly tasks: readonly {
+                readonly title: string;
+                readonly id: string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">;
+                readonly status: "done" | "todo" | "in-progress";
+                readonly parent?: (string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">) | undefined;
+                readonly chat?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+                    readonly name?: string | undefined;
+                    readonly queue: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>>;
+                    readonly traceQueue?: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+                }> | undefined;
+            }[];
+        }>;
+        readonly artifacts: readonly {
+            readonly name: string;
+            readonly data: import("@dxos/echo/internal").Ref<any>;
+        }[];
+        readonly subscriptions: readonly import("@dxos/echo/internal").Ref<any>[];
+        readonly useQualifyingAgent?: boolean | undefined;
+        readonly newChatOnEveryEvent?: boolean | undefined;
+    }>;
+    readonly event?: {
+        readonly from: string;
+        readonly to: string;
+        readonly body: string;
+        readonly created: string;
+        readonly subject: string;
+    } | {
+        readonly queue: string;
+        readonly item: any;
+        readonly cursor: string;
+    } | {
+        readonly type: string;
+        readonly subject: import("@dxos/echo/internal").Ref<any>;
+        readonly changedObjectId?: string | undefined;
+    } | {
+        readonly tick: number;
+    } | {
+        readonly url: string;
+        readonly method: "GET" | "POST";
+        readonly headers: {
+            readonly [x: string]: string;
+        };
+        readonly bodyText: string;
+    } | undefined;
+}, void, import("@dxos/functions").FunctionServices> | import("@dxos/functions").FunctionDefinition<{
+    readonly initiative: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+        readonly name: string;
+        readonly queue?: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+        readonly chat?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly name?: string | undefined;
+            readonly queue: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>>;
+            readonly traceQueue?: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+        }> | undefined;
+        readonly spec: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly content: string;
+        }>;
+        readonly plan: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly tasks: readonly {
+                readonly title: string;
+                readonly id: string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">;
+                readonly status: "done" | "todo" | "in-progress";
+                readonly parent?: (string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">) | undefined;
+                readonly chat?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+                    readonly name?: string | undefined;
+                    readonly queue: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>>;
+                    readonly traceQueue?: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+                }> | undefined;
+            }[];
+        }>;
+        readonly artifacts: readonly {
+            readonly name: string;
+            readonly data: import("@dxos/echo/internal").Ref<any>;
+        }[];
+        readonly subscriptions: readonly import("@dxos/echo/internal").Ref<any>[];
+        readonly useQualifyingAgent?: boolean | undefined;
+        readonly newChatOnEveryEvent?: boolean | undefined;
+    }>;
+    readonly event: {
+        readonly from: string;
+        readonly to: string;
+        readonly body: string;
+        readonly created: string;
+        readonly subject: string;
+    } | {
+        readonly queue: string;
+        readonly item: any;
+        readonly cursor: string;
+    } | {
+        readonly type: string;
+        readonly subject: import("@dxos/echo/internal").Ref<any>;
+        readonly changedObjectId?: string | undefined;
+    } | {
+        readonly tick: number;
+    } | {
+        readonly url: string;
+        readonly method: "GET" | "POST";
+        readonly headers: {
+            readonly [x: string]: string;
+        };
+        readonly bodyText: string;
+    };
+}, void, import("@dxos/functions").FunctionServices>)[];
+/**
+ * Creates the Initiative blueprint. This is a function to avoid circular dependency issues.
+ */
+export declare const makeBlueprint: () => import("@dxos/echo/Obj").Obj<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+    readonly description?: string | undefined;
+    readonly name: string;
+    readonly key: string;
+    readonly instructions: {
+        readonly source: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly content: string;
+        }>;
+        readonly inputs?: readonly {
+            readonly function?: string | undefined;
+            readonly name: string;
+            readonly kind?: "function" | "value" | "pass-through" | "retriever" | "query" | "resolver" | "context" | "schema" | undefined;
+            readonly default?: any;
+        }[] | undefined;
+    };
+    readonly tools: readonly (string & import("effect/Brand").Brand<"ToolId">)[];
+}>;
+//# sourceMappingURL=blueprint.d.ts.map

package/dist/types/src/initiative/blueprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../../../../src/initiative/blueprint.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uDAAoD,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;uBA2CsI,CAAC;6BAA0C,CAAC;;yBAAkF,CAAC;4BAA6I,CAAC;;;;EADza,CAAC"}

package/dist/types/src/initiative/functions/addArtifact.d.ts

@@ -0,0 +1,6 @@
+declare const _default: import("@dxos/functions").FunctionDefinition<{
+    readonly name: string;
+    readonly artifact: import("@dxos/echo/internal").Ref<any>;
+}, void, import("@dxos/functions").FunctionServices>;
+export default _default;
+//# sourceMappingURL=addArtifact.d.ts.map

package/dist/types/src/initiative/functions/addArtifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addArtifact.d.ts","sourceRoot":"","sources":["../../../../../src/initiative/functions/addArtifact.ts"],"names":[],"mappings":";;;;AAaA,wBA2BG"}

package/dist/types/src/initiative/functions/agent.d.ts

@@ -0,0 +1,62 @@
+import { type Queue } from '@dxos/echo-db';
+declare const _default: import("@dxos/functions").FunctionDefinition<{
+    readonly prompt?: string | undefined;
+    readonly initiative: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+        readonly name: string;
+        readonly queue?: import("@dxos/echo/internal").Ref<Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+        readonly chat?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly name?: string | undefined;
+            readonly queue: import("@dxos/echo/internal").Ref<Queue<import("@dxos/echo/Entity").Unknown>>;
+            readonly traceQueue?: import("@dxos/echo/internal").Ref<Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+        }> | undefined;
+        readonly spec: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly content: string;
+        }>;
+        readonly plan: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly tasks: readonly {
+                readonly title: string;
+                readonly id: string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">;
+                readonly status: "done" | "todo" | "in-progress";
+                readonly parent?: (string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">) | undefined;
+                readonly chat?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+                    readonly name?: string | undefined;
+                    readonly queue: import("@dxos/echo/internal").Ref<Queue<import("@dxos/echo/Entity").Unknown>>;
+                    readonly traceQueue?: import("@dxos/echo/internal").Ref<Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+                }> | undefined;
+            }[];
+        }>;
+        readonly artifacts: readonly {
+            readonly name: string;
+            readonly data: import("@dxos/echo/internal").Ref<any>;
+        }[];
+        readonly subscriptions: readonly import("@dxos/echo/internal").Ref<any>[];
+        readonly useQualifyingAgent?: boolean | undefined;
+        readonly newChatOnEveryEvent?: boolean | undefined;
+    }>;
+    readonly event?: {
+        readonly from: string;
+        readonly to: string;
+        readonly body: string;
+        readonly created: string;
+        readonly subject: string;
+    } | {
+        readonly queue: string;
+        readonly item: any;
+        readonly cursor: string;
+    } | {
+        readonly type: string;
+        readonly subject: import("@dxos/echo/internal").Ref<any>;
+        readonly changedObjectId?: string | undefined;
+    } | {
+        readonly tick: number;
+    } | {
+        readonly url: string;
+        readonly method: "GET" | "POST";
+        readonly headers: {
+            readonly [x: string]: string;
+        };
+        readonly bodyText: string;
+    } | undefined;
+}, void, import("@dxos/functions").FunctionServices>;
+export default _default;
+//# sourceMappingURL=agent.d.ts.map

package/dist/types/src/initiative/functions/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../../../src/initiative/functions/agent.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAS3C,wBAyDG"}

package/dist/types/src/initiative/functions/getContext.d.ts

@@ -0,0 +1,13 @@
+declare const _default: import("@dxos/functions").FunctionDefinition<{}, {
+    readonly name: string;
+    readonly id: string;
+    readonly spec: string;
+    readonly plan: string;
+    readonly artifacts: readonly {
+        readonly name: string;
+        readonly type?: string | undefined;
+        readonly dxn?: string | undefined;
+    }[];
+}, import("@dxos/functions").FunctionServices>;
+export default _default;
+//# sourceMappingURL=getContext.d.ts.map

package/dist/types/src/initiative/functions/getContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getContext.d.ts","sourceRoot":"","sources":["../../../../../src/initiative/functions/getContext.ts"],"names":[],"mappings":";;;;;;;;;;;AAcA,wBAuCG"}

package/dist/types/src/initiative/functions/index.d.ts

@@ -0,0 +1,5 @@
+export { default as getContext } from './getContext';
+export { default as addArtifact } from './addArtifact';
+export { default as agent } from './agent';
+export { default as qualifier } from './qualifier';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/initiative/functions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/initiative/functions/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/types/src/initiative/functions/qualifier.d.ts

@@ -0,0 +1,60 @@
+declare const _default: import("@dxos/functions").FunctionDefinition<{
+    readonly initiative: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+        readonly name: string;
+        readonly queue?: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+        readonly chat?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly name?: string | undefined;
+            readonly queue: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>>;
+            readonly traceQueue?: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+        }> | undefined;
+        readonly spec: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly content: string;
+        }>;
+        readonly plan: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly tasks: readonly {
+                readonly title: string;
+                readonly id: string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">;
+                readonly status: "done" | "todo" | "in-progress";
+                readonly parent?: (string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">) | undefined;
+                readonly chat?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+                    readonly name?: string | undefined;
+                    readonly queue: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>>;
+                    readonly traceQueue?: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+                }> | undefined;
+            }[];
+        }>;
+        readonly artifacts: readonly {
+            readonly name: string;
+            readonly data: import("@dxos/echo/internal").Ref<any>;
+        }[];
+        readonly subscriptions: readonly import("@dxos/echo/internal").Ref<any>[];
+        readonly useQualifyingAgent?: boolean | undefined;
+        readonly newChatOnEveryEvent?: boolean | undefined;
+    }>;
+    readonly event: {
+        readonly from: string;
+        readonly to: string;
+        readonly body: string;
+        readonly created: string;
+        readonly subject: string;
+    } | {
+        readonly queue: string;
+        readonly item: any;
+        readonly cursor: string;
+    } | {
+        readonly type: string;
+        readonly subject: import("@dxos/echo/internal").Ref<any>;
+        readonly changedObjectId?: string | undefined;
+    } | {
+        readonly tick: number;
+    } | {
+        readonly url: string;
+        readonly method: "GET" | "POST";
+        readonly headers: {
+            readonly [x: string]: string;
+        };
+        readonly bodyText: string;
+    };
+}, void, import("@dxos/functions").FunctionServices>;
+export default _default;
+//# sourceMappingURL=qualifier.d.ts.map

package/dist/types/src/initiative/functions/qualifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualifier.d.ts","sourceRoot":"","sources":["../../../../../src/initiative/functions/qualifier.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,wBA+EG"}

package/dist/types/src/initiative/index.d.ts

@@ -0,0 +1,6 @@
+export { Initiative } from './Initiative';
+export { makeInitialized, resetChatHistory, getFromChatContext } from './util';
+export { getFunctions, makeBlueprint } from './blueprint';
+export * from './functions';
+export * from './plan';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/initiative/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/initiative/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1D,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC"}

package/dist/types/src/initiative/initiative.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=initiative.test.d.ts.map

package/dist/types/src/initiative/initiative.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initiative.test.d.ts","sourceRoot":"","sources":["../../../../src/initiative/initiative.test.ts"],"names":[],"mappings":""}

package/dist/types/src/initiative/plan.d.ts

@@ -0,0 +1,77 @@
+import * as Schema from 'effect/Schema';
+import { Obj, Type } from '@dxos/echo';
+export declare const TaskId: Schema.brand<typeof Schema.String, "@dxos/assistant-toolkit/TaskId">;
+export type TaskId = Schema.Schema.Type<typeof TaskId>;
+export declare const Task: Schema.Struct<{
+    /**
+     * Short task ID unique within the plan.
+     */
+    id: Schema.brand<typeof Schema.String, "@dxos/assistant-toolkit/TaskId">;
+    title: Schema.SchemaClass<string, string, never>;
+    status: Schema.Literal<["todo", "in-progress", "done"]>;
+    /**
+     * Parent task ID.
+     */
+    parent: Schema.optional<Schema.brand<typeof Schema.String, "@dxos/assistant-toolkit/TaskId">>;
+    /**
+     * Chat object that this task is associated with.
+     */
+    chat: Schema.optional<import("@dxos/echo/internal").RefSchema<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+        readonly name?: string | undefined;
+        readonly queue: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>>;
+        readonly traceQueue?: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+    }>>;
+}>;
+export interface Task extends Schema.Schema.Type<typeof Task> {
+}
+/**
+ * Hierarchical collection of tasks for humans and agents to track progress.
+ */
+export declare const Plan: Type.Obj<{
+    readonly tasks: readonly {
+        readonly title: string;
+        readonly id: string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">;
+        readonly status: "done" | "todo" | "in-progress";
+        readonly parent?: (string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">) | undefined;
+        readonly chat?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly name?: string | undefined;
+            readonly queue: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>>;
+            readonly traceQueue?: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+        }> | undefined;
+    }[];
+}, Schema.Struct.Fields>;
+export interface Plan extends Schema.Schema.Type<typeof Plan> {
+}
+export declare const generateTaskId: (plan: Plan) => TaskId;
+/**
+ * Add new tasks to a plan, generating IDs for new tasks.
+ * Use inside an `Obj.change` callback.
+ */
+export declare const addTasks: (plan: Obj.Mutable<Plan>, tasks: (Pick<Task, "title"> & Partial<Pick<Task, "status" | "parent" | "chat">>)[]) => {
+    id: import("@dxos/keys").ObjectId;
+    "~@dxos/echo/Kind": import("@dxos/echo/internal").EntityKind.Object;
+    tasks: {
+        title: string;
+        id: string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">;
+        status: "done" | "todo" | "in-progress";
+        parent?: (string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">) | undefined;
+        chat?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly name?: string | undefined;
+            readonly queue: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>>;
+            readonly traceQueue?: import("@dxos/echo/internal").Ref<import("@dxos/echo-db").Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
+        }> | undefined;
+    }[];
+};
+interface MakePlanProps {
+    tasks: {
+        title: string;
+        status?: 'todo' | 'in-progress' | 'done';
+    }[];
+}
+export declare const makePlan: (props: MakePlanProps) => Plan;
+/**
+ * Formats plan to markdown format.
+ */
+export declare const formatPlan: (plan: Plan) => string;
+export {};
+//# sourceMappingURL=plan.d.ts.map

package/dist/types/src/initiative/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../../src/initiative/plan.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIvC,eAAO,MAAM,MAAM,sEAAqE,CAAC;AACzF,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,CAAC;AAEvD,eAAO,MAAM,IAAI;IACf;;OAEG;;;;IASH;;OAEG;;IAKH;;OAEG;;;;;;EAEH,CAAC;AACH,MAAM,WAAW,IAAK,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC;CAAG;AAEhE;;GAEG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;wBAOhB,CAAC;AACF,MAAM,WAAW,IAAK,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC;CAAG;AAEhE,eAAO,MAAM,cAAc,GAAI,MAAM,IAAI,KAAG,MAe3C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,QAAQ,GACnB,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EACvB,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;CAOnF,CAAC;AAEF,UAAU,aAAa;IACrB,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;KAC1C,EAAE,CAAC;CACL;AAED,eAAO,MAAM,QAAQ,GAAI,OAAO,aAAa,KAAG,IAM/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,KAAG,MAIvC,CAAC"}

package/dist/types/src/initiative/util.d.ts

@@ -0,0 +1,29 @@
+import * as Effect from 'effect/Effect';
+import { AiContextService } from '@dxos/assistant';
+import { type Blueprint } from '@dxos/blueprints';
+import { Database, Obj, Ref } from '@dxos/echo';
+import { type ObjectNotFoundError } from '@dxos/echo/Err';
+import { QueueService } from '@dxos/functions';
+import { Initiative } from './Initiative';
+/**
+ * Creates a fully initialized Initiative with chat, queue, and context bindings.
+ *
+ * @param props - Initiative properties including spec, plan, blueprints, and context objects.
+ * @param blueprint - The blueprint to use for the initiative context.
+ * @returns An Effect that yields the initialized Initiative.
+ */
+export declare const makeInitialized: (props: Omit<Obj.MakeProps<typeof Initiative>, "spec" | "plan" | "artifacts" | "subscriptions" | "chat"> & Partial<Pick<Obj.MakeProps<typeof Initiative>, "artifacts" | "subscriptions">> & {
+    spec: string;
+    blueprints?: Ref.Ref<Blueprint.Blueprint>[];
+    contextObjects?: Ref.Ref<Obj.Any>[];
+}, blueprint: Blueprint.Blueprint) => Effect.Effect<Initiative, never, QueueService | Database.Service>;
+/**
+ * Resets the initiative chat history by rebuilding the chat context.
+ * Preserves the existing blueprints and objects from the current chat context.
+ *
+ * @param initiative - The initiative whose chat history should be reset. Must have an existing chat.
+ * @returns An Effect that resets the chat history.
+ */
+export declare const resetChatHistory: (initiative: Initiative) => Effect.Effect<void, ObjectNotFoundError, QueueService | Database.Service>;
+export declare const getFromChatContext: Effect.Effect<Initiative, never, AiContextService>;
+//# sourceMappingURL=util.d.ts.map