@dxos/assistant-toolkit 0.8.4-main.66e292d → 0.8.4-main.6fa680abb7

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

@@ -0,0 +1,77 @@
+import * as Schema from 'effect/Schema';
+import { Obj, Ref, 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<Ref.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 id: string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">;
+        readonly status: "done" | "todo" | "in-progress";
+        readonly title: string;
+        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: {
+        id: string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">;
+        status: "done" | "todo" | "in-progress";
+        title: string;
+        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/types/Plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plan.d.ts","sourceRoot":"","sources":["../../../../src/types/Plan.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAc,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIxD,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;;;;;;;;;;;;wBAQhB,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/types/Project.d.ts

@@ -0,0 +1,67 @@
+import * as Effect from 'effect/Effect';
+import * as Schema from 'effect/Schema';
+import { AiContextService } from '@dxos/assistant';
+import { type Blueprint } from '@dxos/blueprints';
+import { Type } from '@dxos/echo';
+import { Database, Obj, Ref } from '@dxos/echo';
+import { type ObjectNotFoundError } from '@dxos/echo/Err';
+import { Queue } from '@dxos/echo-db';
+import { QueueService } from '@dxos/functions';
+/**
+ * Project schema definition.
+ */
+export declare const Project: 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 id: string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">;
+            readonly status: "done" | "todo" | "in-progress";
+            readonly title: string;
+            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<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+    }[];
+    readonly subscriptions: readonly import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>[];
+    readonly useQualifyingAgent?: boolean | undefined;
+}, Schema.Struct.Fields>;
+export interface Project extends Schema.Schema.Type<typeof Project> {
+}
+/**
+ * Creates a fully initialized Project with chat, queue, and context bindings.
+ *
+ * @param props - Project properties including spec, plan, blueprints, and context objects.
+ * @param blueprint - The blueprint to use for the project context.
+ * @returns An Effect that yields the initialized Project.
+ */
+export declare const makeInitialized: (props: Omit<Obj.MakeProps<typeof Project>, "spec" | "plan" | "artifacts" | "subscriptions" | "chat"> & Partial<Pick<Obj.MakeProps<typeof Project>, "artifacts" | "subscriptions">> & {
+    spec: string;
+    blueprints?: Ref.Ref<Blueprint.Blueprint>[];
+    contextObjects?: Ref.Ref<Obj.Any>[];
+}, blueprint: Blueprint.Blueprint) => Effect.Effect<Project, never, QueueService | Database.Service>;
+/**
+ * Resets the project chat history by rebuilding the chat context.
+ * Preserves the existing blueprints and objects from the current chat context.
+ *
+ * @param project - The project whose chat history should be reset. Must have an existing chat.
+ * @returns An Effect that resets the chat history.
+ */
+export declare const resetChatHistory: (project: Project) => Effect.Effect<void, ObjectNotFoundError, QueueService | Database.Service>;
+export declare const getFromChatContext: Effect.Effect<Project, never, AiContextService>;
+//# sourceMappingURL=Project.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Project.d.ts","sourceRoot":"","sources":["../../../../src/types/Project.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAmB,gBAAgB,EAAuB,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAc,IAAI,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAY,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAQ/C;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA6CnB,CAAC;AAEF,MAAM,WAAW,OAAQ,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC;CAAG;AAEtE;;;;;;GAMG;AAEH,eAAO,MAAM,eAAe,GAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,MAAM,CAAC,GAClG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,OAAO,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC,CAAC,GAAG;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;IAC5C,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;CACrC,EACH,WAAW,SAAS,CAAC,SAAS,KAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,YAAY,GAAG,QAAQ,CAAC,OAAO,CA0C5D,CAAC;AAEL;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,OAAO,KACf,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE,YAAY,GAAG,QAAQ,CAAC,OAAO,CAyCnD,CAAC;AAEzB,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,gBAAgB,CAO7E,CAAC"}

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

@@ -0,0 +1,5 @@
+export * as Chat from './Chat';
+export * as Project from './Project';
+export * as Plan from './Plan';
+export * as Memory from './Memory';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC"}