@digimuza/system-core 0.2.0-rc.2 → 0.3.0-rc.1

package/dist/ai/contract.d.ts

@@ -0,0 +1,364 @@
+import { type GenericId, type Infer } from "convex/values";
+import type { z } from "zod";
+import type { Actor, ActorRef } from "../core/access.js";
+import type { SystemContext } from "../core/context.js";
+export declare const actorRefValidator: import("convex/values").VUnion<{
+    kind: "user";
+    userId: string;
+} | {
+    apiKeyId: string;
+    kind: "agent";
+}, [import("convex/values").VObject<{
+    kind: "user";
+    userId: string;
+}, {
+    kind: import("convex/values").VLiteral<"user", "required">;
+    userId: import("convex/values").VString<string, "required">;
+}, "required", "kind" | "userId">, import("convex/values").VObject<{
+    apiKeyId: string;
+    kind: "agent";
+}, {
+    kind: import("convex/values").VLiteral<"agent", "required">;
+    apiKeyId: import("convex/values").VString<string, "required">;
+}, "required", "apiKeyId" | "kind">], "required", "apiKeyId" | "kind" | "userId">;
+export declare const toolCallState: import("convex/values").VUnion<"approved" | "awaiting-approval" | "done" | "error" | "rejected" | "running", [import("convex/values").VLiteral<"awaiting-approval", "required">, import("convex/values").VLiteral<"approved", "required">, import("convex/values").VLiteral<"rejected", "required">, import("convex/values").VLiteral<"running", "required">, import("convex/values").VLiteral<"done", "required">, import("convex/values").VLiteral<"error", "required">], "required", never>;
+export declare const messagePart: import("convex/values").VUnion<{
+    text: string;
+    type: "text";
+} | {
+    args: any;
+    error?: string | undefined;
+    result?: any;
+    state: "approved" | "awaiting-approval" | "done" | "error" | "rejected" | "running";
+    toolCallId: string;
+    toolName: string;
+    type: "tool-call";
+}, [import("convex/values").VObject<{
+    text: string;
+    type: "text";
+}, {
+    type: import("convex/values").VLiteral<"text", "required">;
+    text: import("convex/values").VString<string, "required">;
+}, "required", "text" | "type">, import("convex/values").VObject<{
+    args: any;
+    error?: string | undefined;
+    result?: any;
+    state: "approved" | "awaiting-approval" | "done" | "error" | "rejected" | "running";
+    toolCallId: string;
+    toolName: string;
+    type: "tool-call";
+}, {
+    type: import("convex/values").VLiteral<"tool-call", "required">;
+    toolCallId: import("convex/values").VString<string, "required">;
+    toolName: import("convex/values").VString<string, "required">;
+    args: import("convex/values").VAny<any, "required", string>;
+    state: import("convex/values").VUnion<"approved" | "awaiting-approval" | "done" | "error" | "rejected" | "running", [import("convex/values").VLiteral<"awaiting-approval", "required">, import("convex/values").VLiteral<"approved", "required">, import("convex/values").VLiteral<"rejected", "required">, import("convex/values").VLiteral<"running", "required">, import("convex/values").VLiteral<"done", "required">, import("convex/values").VLiteral<"error", "required">], "required", never>;
+    result: import("convex/values").VAny<any, "optional", string>;
+    /** Stable system-core error code (FORBIDDEN, VALIDATION, …) or a short message. */
+    error: import("convex/values").VString<string | undefined, "optional">;
+}, "required", "args" | "error" | "result" | "state" | "toolCallId" | "toolName" | "type" | `args.${string}` | `result.${string}`>], "required", "args" | "error" | "result" | "state" | "text" | "toolCallId" | "toolName" | "type" | `args.${string}` | `result.${string}`>;
+export declare const threadStatus: import("convex/values").VUnion<"idle" | "running" | "waiting-approval", [import("convex/values").VLiteral<"idle", "required">, import("convex/values").VLiteral<"running", "required">, import("convex/values").VLiteral<"waiting-approval", "required">], "required", never>;
+export declare const messageStatus: import("convex/values").VUnion<"done" | "error" | "stopped" | "streaming", [import("convex/values").VLiteral<"streaming", "required">, import("convex/values").VLiteral<"done", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"stopped", "required">], "required", never>;
+export declare const runStatus: import("convex/values").VUnion<"done" | "error" | "queued" | "running" | "stopped" | "waiting-approval", [import("convex/values").VLiteral<"queued", "required">, import("convex/values").VLiteral<"running", "required">, import("convex/values").VLiteral<"waiting-approval", "required">, import("convex/values").VLiteral<"done", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"stopped", "required">], "required", never>;
+/** Spread into the app schema next to `systemTables`. */
+export declare const aiTables: {
+    aiThreads: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        agentId: string;
+        archived: boolean;
+        createdAt: number;
+        ownerId: string;
+        status: "idle" | "running" | "waiting-approval";
+        title: string;
+        updatedAt: number;
+    }, {
+        /** system-core user key of the owner. Only the owner can see a thread. */
+        ownerId: import("convex/values").VString<string, "required">;
+        title: import("convex/values").VString<string, "required">;
+        agentId: import("convex/values").VString<string, "required">;
+        status: import("convex/values").VUnion<"idle" | "running" | "waiting-approval", [import("convex/values").VLiteral<"idle", "required">, import("convex/values").VLiteral<"running", "required">, import("convex/values").VLiteral<"waiting-approval", "required">], "required", never>;
+        archived: import("convex/values").VBoolean<boolean, "required">;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "agentId" | "archived" | "createdAt" | "ownerId" | "status" | "title" | "updatedAt">, {
+        by_owner: ["ownerId", "archived", "updatedAt", "_creationTime"];
+    }, {}, {}>;
+    aiMessages: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        createdAt: number;
+        error?: {
+            code: string;
+            message: string;
+            operationId?: string | undefined;
+        } | undefined;
+        parts: ({
+            text: string;
+            type: "text";
+        } | {
+            args: any;
+            error?: string | undefined;
+            result?: any;
+            state: "approved" | "awaiting-approval" | "done" | "error" | "rejected" | "running";
+            toolCallId: string;
+            toolName: string;
+            type: "tool-call";
+        })[];
+        role: "assistant" | "user";
+        runId?: GenericId<"aiRuns"> | undefined;
+        status: "done" | "error" | "stopped" | "streaming";
+        threadId: GenericId<"aiThreads">;
+    }, {
+        threadId: import("convex/values").VId<GenericId<"aiThreads">, "required">;
+        role: import("convex/values").VUnion<"assistant" | "user", [import("convex/values").VLiteral<"user", "required">, import("convex/values").VLiteral<"assistant", "required">], "required", never>;
+        parts: import("convex/values").VArray<({
+            text: string;
+            type: "text";
+        } | {
+            args: any;
+            error?: string | undefined;
+            result?: any;
+            state: "approved" | "awaiting-approval" | "done" | "error" | "rejected" | "running";
+            toolCallId: string;
+            toolName: string;
+            type: "tool-call";
+        })[], import("convex/values").VUnion<{
+            text: string;
+            type: "text";
+        } | {
+            args: any;
+            error?: string | undefined;
+            result?: any;
+            state: "approved" | "awaiting-approval" | "done" | "error" | "rejected" | "running";
+            toolCallId: string;
+            toolName: string;
+            type: "tool-call";
+        }, [import("convex/values").VObject<{
+            text: string;
+            type: "text";
+        }, {
+            type: import("convex/values").VLiteral<"text", "required">;
+            text: import("convex/values").VString<string, "required">;
+        }, "required", "text" | "type">, import("convex/values").VObject<{
+            args: any;
+            error?: string | undefined;
+            result?: any;
+            state: "approved" | "awaiting-approval" | "done" | "error" | "rejected" | "running";
+            toolCallId: string;
+            toolName: string;
+            type: "tool-call";
+        }, {
+            type: import("convex/values").VLiteral<"tool-call", "required">;
+            toolCallId: import("convex/values").VString<string, "required">;
+            toolName: import("convex/values").VString<string, "required">;
+            args: import("convex/values").VAny<any, "required", string>;
+            state: import("convex/values").VUnion<"approved" | "awaiting-approval" | "done" | "error" | "rejected" | "running", [import("convex/values").VLiteral<"awaiting-approval", "required">, import("convex/values").VLiteral<"approved", "required">, import("convex/values").VLiteral<"rejected", "required">, import("convex/values").VLiteral<"running", "required">, import("convex/values").VLiteral<"done", "required">, import("convex/values").VLiteral<"error", "required">], "required", never>;
+            result: import("convex/values").VAny<any, "optional", string>;
+            /** Stable system-core error code (FORBIDDEN, VALIDATION, …) or a short message. */
+            error: import("convex/values").VString<string | undefined, "optional">;
+        }, "required", "args" | "error" | "result" | "state" | "toolCallId" | "toolName" | "type" | `args.${string}` | `result.${string}`>], "required", "args" | "error" | "result" | "state" | "text" | "toolCallId" | "toolName" | "type" | `args.${string}` | `result.${string}`>, "required">;
+        status: import("convex/values").VUnion<"done" | "error" | "stopped" | "streaming", [import("convex/values").VLiteral<"streaming", "required">, import("convex/values").VLiteral<"done", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"stopped", "required">], "required", never>;
+        /** `operationId` is the run's, so support can find the logs of a failed answer. */
+        error: import("convex/values").VObject<{
+            code: string;
+            message: string;
+            operationId?: string | undefined;
+        } | undefined, {
+            code: import("convex/values").VString<string, "required">;
+            message: import("convex/values").VString<string, "required">;
+            operationId: import("convex/values").VString<string | undefined, "optional">;
+        }, "optional", "code" | "message" | "operationId">;
+        runId: import("convex/values").VId<GenericId<"aiRuns"> | undefined, "optional">;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "createdAt" | "error" | "error.code" | "error.message" | "error.operationId" | "parts" | "role" | "runId" | "status" | "threadId">, {
+        by_thread: ["threadId", "createdAt", "_creationTime"];
+    }, {}, {}>;
+    aiRuns: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        actor: {
+            kind: "user";
+            userId: string;
+        } | {
+            apiKeyId: string;
+            kind: "agent";
+        };
+        agentId: string;
+        createdAt: number;
+        error?: {
+            code: string;
+            message: string;
+        } | undefined;
+        messageId: GenericId<"aiMessages">;
+        model: string;
+        operationId: string;
+        status: "done" | "error" | "queued" | "running" | "stopped" | "waiting-approval";
+        stopRequested: boolean;
+        threadId: GenericId<"aiThreads">;
+        updatedAt: number;
+    }, {
+        threadId: import("convex/values").VId<GenericId<"aiThreads">, "required">;
+        /** The assistant message this run writes into. */
+        messageId: import("convex/values").VId<GenericId<"aiMessages">, "required">;
+        /** Who the run acts for; re-authorized on every tool call (system-core authorizeJob). */
+        actor: import("convex/values").VUnion<{
+            kind: "user";
+            userId: string;
+        } | {
+            apiKeyId: string;
+            kind: "agent";
+        }, [import("convex/values").VObject<{
+            kind: "user";
+            userId: string;
+        }, {
+            kind: import("convex/values").VLiteral<"user", "required">;
+            userId: import("convex/values").VString<string, "required">;
+        }, "required", "kind" | "userId">, import("convex/values").VObject<{
+            apiKeyId: string;
+            kind: "agent";
+        }, {
+            kind: import("convex/values").VLiteral<"agent", "required">;
+            apiKeyId: import("convex/values").VString<string, "required">;
+        }, "required", "apiKeyId" | "kind">], "required", "apiKeyId" | "kind" | "userId">;
+        agentId: import("convex/values").VString<string, "required">;
+        model: import("convex/values").VString<string, "required">;
+        status: import("convex/values").VUnion<"done" | "error" | "queued" | "running" | "stopped" | "waiting-approval", [import("convex/values").VLiteral<"queued", "required">, import("convex/values").VLiteral<"running", "required">, import("convex/values").VLiteral<"waiting-approval", "required">, import("convex/values").VLiteral<"done", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"stopped", "required">], "required", never>;
+        stopRequested: import("convex/values").VBoolean<boolean, "required">;
+        operationId: import("convex/values").VString<string, "required">;
+        error: import("convex/values").VObject<{
+            code: string;
+            message: string;
+        } | undefined, {
+            code: import("convex/values").VString<string, "required">;
+            message: import("convex/values").VString<string, "required">;
+        }, "optional", "code" | "message">;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "actor" | "actor.apiKeyId" | "actor.kind" | "actor.userId" | "agentId" | "createdAt" | "error" | "error.code" | "error.message" | "messageId" | "model" | "operationId" | "status" | "stopRequested" | "threadId" | "updatedAt">, {
+        by_message: ["messageId", "_creationTime"];
+        by_thread: ["threadId", "createdAt", "_creationTime"];
+    }, {}, {}>;
+};
+export type MessagePart = Infer<typeof messagePart>;
+export type ToolCallState = Infer<typeof toolCallState>;
+export type ThreadStatus = Infer<typeof threadStatus>;
+export type MessageStatus = Infer<typeof messageStatus>;
+export type RunStatus = Infer<typeof runStatus>;
+export type AiThreadId = GenericId<"aiThreads">;
+export type AiMessageId = GenericId<"aiMessages">;
+export type AiRunId = GenericId<"aiRuns">;
+export interface ThreadView {
+    id: AiThreadId;
+    title: string;
+    agentId: string;
+    status: ThreadStatus;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface MessageView {
+    id: AiMessageId;
+    role: "user" | "assistant";
+    parts: MessagePart[];
+    status: MessageStatus;
+    /** Set when the answer failed; `operationId` is the run's (show it so support can trace it). */
+    error: {
+        code: string;
+        message: string;
+        operationId?: string;
+    } | null;
+    createdAt: number;
+}
+export interface AgentToolView {
+    id: string;
+    description: string;
+    requiresApproval: boolean;
+}
+export interface AgentView {
+    id: string;
+    name: string;
+    description: string;
+    /** Only the tools the caller holds the permission for right now. */
+    tools: AgentToolView[];
+}
+/** What a tool handler gets. It runs inside an internal mutation, as the run's actor. */
+export interface AiToolContext {
+    db: any;
+    sys: SystemContext;
+    /** Re-authorized for `permission` right before the handler runs. */
+    actor: Actor;
+}
+export interface AiTool<I extends z.ZodType = z.ZodType, O = unknown> {
+    /** Stable, `module.verb_object` style, e.g. `finance.list_invoices`. Shown to the model. */
+    id: string;
+    /** For the model: what it does and when to use it. */
+    description: string;
+    /** Zod schema of the arguments (also sent to the model as JSON schema). */
+    input: I;
+    /** system-core permission required to run it, e.g. `finance:invoice:read`. */
+    permission: string;
+    /** Writes or anything risky: the user approves each call first. */
+    requiresApproval?: boolean;
+    /**
+     * Must be JSON-serializable. Throw SystemError for expected failures.
+     *
+     * Validate everything before the first write: a failed handler does not roll
+     * back. `executeAiTool` returns the failure instead of throwing (so the
+     * `ai.tool.run` audit survives), therefore writes made before the throw are
+     * committed with the surrounding mutation.
+     */
+    handler(ctx: AiToolContext, input: z.infer<I>): Promise<O>;
+}
+export interface AiAgentDefinition {
+    /** Stable id, e.g. `assistant`. */
+    id: string;
+    name: string;
+    description: string;
+    /** System prompt. */
+    instructions: string;
+    /** Model id for this agent; falls back to `defaultModel`. OpenAI only in v1. */
+    model?: string;
+    tools: readonly AiTool<any, any>[];
+}
+export interface AiOptions {
+    agents: readonly AiAgentDefinition[];
+    /** Default OpenAI model id when an agent has none (env AI_MODEL wins if set). */
+    defaultModel: string;
+    /**
+     * Convex module paths (relative to convex/) where the app exports the AI
+     * functions and the Node runner. Defaults: "ai" and "aiRunner".
+     */
+    functionsModule?: string;
+    runnerModule?: string;
+}
+/** Public functions in `functionsModule` (default convex/ai.ts). */
+export declare const AI_PUBLIC_FUNCTIONS: readonly ["listAgents", "listThreads", "getThread", "listMessages", "createThread", "sendMessage", "stopRun", "respondToToolCall", "renameThread", "archiveThread"];
+/** Internal functions in `functionsModule`, called by the runner. */
+export declare const AI_INTERNAL_FUNCTIONS: readonly ["_startRun", "_appendText", "_addToolCall", "_executeTool", "_setToolCallState", "_finishRun", "_isStopRequested"];
+/** Node runner in `runnerModule` (default convex/aiRunner.ts, "use node"). */
+export declare const AI_RUNNER_FUNCTION = "runAgent";
+/** What `_startRun` gives the runner. */
+export interface RunContext {
+    runId: AiRunId;
+    threadId: AiThreadId;
+    messageId: AiMessageId;
+    agentId: string;
+    model: string;
+    actor: ActorRef;
+    operationId: string;
+    /** Full history in order, including this run's assistant message so far. */
+    history: MessageView[];
+    /** Tool ids of the agent the actor may use right now (permission held). */
+    allowedToolIds: string[];
+}
+export type ToolExecutionResult = {
+    ok: true;
+    result: unknown;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+};
+export declare const AI_AUDIT: {
+    readonly threadCreate: "ai.thread.create";
+    readonly messageSend: "ai.message.send";
+    readonly toolRun: "ai.tool.run";
+    readonly toolApprove: "ai.tool.approve";
+    readonly toolReject: "ai.tool.reject";
+    readonly runStop: "ai.run.stop";
+};
+//# sourceMappingURL=contract.d.ts.map

package/dist/ai/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/ai/contract.ts"],"names":[],"mappings":"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"}

package/dist/ai/contract.js

@@ -0,0 +1,101 @@
+// Shared contract of the AI module (DIG-71). Every part of `@digimuza/system-core/ai`
+// builds on these shapes: tables, views, function names, the tool and agent API.
+// No Mastra or AI SDK imports here: this file is safe in Convex's default runtime
+// and in the browser (types only).
+import { defineTable } from "convex/server";
+import { v } from "convex/values";
+// --- Validators & tables -------------------------------------------------------------
+export const actorRefValidator = v.union(v.object({ kind: v.literal("user"), userId: v.string() }), v.object({ kind: v.literal("agent"), apiKeyId: v.string() }));
+export const toolCallState = v.union(v.literal("awaiting-approval"), // requiresApproval tool, waiting for the user
+v.literal("approved"), // user approved; the runner executes it next
+v.literal("rejected"), // user rejected; the model is told so
+v.literal("running"), v.literal("done"), v.literal("error"));
+export const messagePart = v.union(v.object({ type: v.literal("text"), text: v.string() }), v.object({
+    type: v.literal("tool-call"),
+    toolCallId: v.string(),
+    toolName: v.string(),
+    args: v.any(),
+    state: toolCallState,
+    result: v.optional(v.any()),
+    /** Stable system-core error code (FORBIDDEN, VALIDATION, …) or a short message. */
+    error: v.optional(v.string()),
+}));
+export const threadStatus = v.union(v.literal("idle"), v.literal("running"), v.literal("waiting-approval"));
+export const messageStatus = v.union(v.literal("streaming"), v.literal("done"), v.literal("error"), v.literal("stopped"));
+export const runStatus = v.union(v.literal("queued"), v.literal("running"), v.literal("waiting-approval"), v.literal("done"), v.literal("error"), v.literal("stopped"));
+/** Spread into the app schema next to `systemTables`. */
+export const aiTables = {
+    aiThreads: defineTable({
+        /** system-core user key of the owner. Only the owner can see a thread. */
+        ownerId: v.string(),
+        title: v.string(),
+        agentId: v.string(),
+        status: threadStatus,
+        archived: v.boolean(),
+        createdAt: v.number(),
+        updatedAt: v.number(),
+    }).index("by_owner", ["ownerId", "archived", "updatedAt"]),
+    aiMessages: defineTable({
+        threadId: v.id("aiThreads"),
+        role: v.union(v.literal("user"), v.literal("assistant")),
+        parts: v.array(messagePart),
+        status: messageStatus,
+        /** `operationId` is the run's, so support can find the logs of a failed answer. */
+        error: v.optional(v.object({ code: v.string(), message: v.string(), operationId: v.optional(v.string()) })),
+        runId: v.optional(v.id("aiRuns")),
+        createdAt: v.number(),
+    }).index("by_thread", ["threadId", "createdAt"]),
+    aiRuns: defineTable({
+        threadId: v.id("aiThreads"),
+        /** The assistant message this run writes into. */
+        messageId: v.id("aiMessages"),
+        /** Who the run acts for; re-authorized on every tool call (system-core authorizeJob). */
+        actor: actorRefValidator,
+        agentId: v.string(),
+        model: v.string(),
+        status: runStatus,
+        stopRequested: v.boolean(),
+        operationId: v.string(),
+        error: v.optional(v.object({ code: v.string(), message: v.string() })),
+        createdAt: v.number(),
+        updatedAt: v.number(),
+    })
+        .index("by_thread", ["threadId", "createdAt"])
+        .index("by_message", ["messageId"]),
+};
+// --- Function names (the app re-exports these) ---------------------------------------
+/** Public functions in `functionsModule` (default convex/ai.ts). */
+export const AI_PUBLIC_FUNCTIONS = [
+    "listAgents", // () → AgentView[]
+    "listThreads", // ({ cursor?, limit? }) → { items: ThreadView[], cursor, done }
+    "getThread", // ({ threadId }) → ThreadView (NOT_FOUND unless owner)
+    "listMessages", // ({ threadId }) → MessageView[] (live, ascending)
+    "createThread", // ({ agentId?, title? }) → { threadId }
+    "sendMessage", // ({ threadId, text }) → { messageId, runId }; schedules the runner
+    "stopRun", // ({ threadId }) → { stopped }
+    "respondToToolCall", // ({ messageId, toolCallId, approve }) → { runId }; resumes the run
+    "renameThread", // ({ threadId, title })
+    "archiveThread", // ({ threadId })
+];
+/** Internal functions in `functionsModule`, called by the runner. */
+export const AI_INTERNAL_FUNCTIONS = [
+    "_startRun", // ({ runId }) → RunContext | null (null: stopped or gone)
+    "_appendText", // ({ messageId, text }) append to the last text part (or start one)
+    "_addToolCall", // ({ messageId, toolCallId, toolName, args, state })
+    "_executeTool", // ({ runId, toolCallId }) → ToolExecutionResult; authorizes and runs the handler
+    "_setToolCallState", // ({ messageId, toolCallId, state, result?, error? })
+    "_finishRun", // ({ runId, status, error? }) sets run, message and thread status
+    "_isStopRequested", // ({ runId }) → boolean
+];
+/** Node runner in `runnerModule` (default convex/aiRunner.ts, "use node"). */
+export const AI_RUNNER_FUNCTION = "runAgent"; // internalAction ({ runId }) → void
+// --- Audit actions ------------------------------------------------------------------------
+export const AI_AUDIT = {
+    threadCreate: "ai.thread.create",
+    messageSend: "ai.message.send",
+    toolRun: "ai.tool.run",
+    toolApprove: "ai.tool.approve",
+    toolReject: "ai.tool.reject",
+    runStop: "ai.run.stop",
+};
+//# sourceMappingURL=contract.js.map

package/dist/ai/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/ai/contract.ts"],"names":[],"mappings":"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"}

package/dist/ai/display.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export * from "./card.js";
+export declare const AI_SHOW_CARD = "ai.show_card";
+/** `ai.show_card`: no data access, no writes, so no approval; needs only `ai:chat:use`. */
+export declare const showCardTool: import("./contract.js").AiTool<z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    html: z.ZodString;
+}, z.core.$strip>, {
+    shown: boolean;
+    bytes: number;
+}>;
+/** Tools for showing things to the user. Add to an agent: `tools: [...financeTools, ...displayTools]`. */
+export declare const displayTools: readonly [import("./contract.js").AiTool<z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    html: z.ZodString;
+}, z.core.$strip>, {
+    shown: boolean;
+    bytes: number;
+}>];
+//# sourceMappingURL=display.d.ts.map

package/dist/ai/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/ai/display.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,cAAc,WAAW,CAAA;AAEzB,eAAO,MAAM,YAAY,iBAAiB,CAAA;AAE1C,2FAA2F;AAC3F,eAAO,MAAM,YAAY;;;;;;EAgBvB,CAAA;AAEF,0GAA0G;AAC1G,eAAO,MAAM,YAAY;;;;;;GAA0B,CAAA"}

package/dist/ai/display.js

@@ -0,0 +1,35 @@
+// Display tools of the AI module: the assistant shows the user a visual card
+// (summary, comparison, table, simple chart) made of HTML/CSS/inline SVG.
+//
+// The HTML is model output and therefore UNTRUSTED (prompt injection can reach
+// it through tool results). Apps must render it only with `cardDocument()` in an
+// <iframe sandbox="allow-scripts"> (never allow-same-origin): opaque origin, no
+// network, no navigation, no forms, no popups. Nothing leaves the frame except
+// the height message the frame's own resize script posts.
+import { z } from "zod";
+import { AiPermissions } from "./manifest.js";
+import { AI_CARD_HTML_MAX, AI_CARD_TITLE_MAX } from "./card.js";
+import { defineAiTool } from "./tools.js";
+export * from "./card.js";
+export const AI_SHOW_CARD = "ai.show_card";
+/** `ai.show_card`: no data access, no writes, so no approval; needs only `ai:chat:use`. */
+export const showCardTool = defineAiTool({
+    id: AI_SHOW_CARD,
+    description: [
+        "Show the user a visual card rendered from HTML, inside the chat.",
+        "Use it when a visual answer is clearly better than text: a summary with key figures, a comparison, a small table, a status overview, a simple bar chart (HTML/CSS or inline SVG).",
+        "Rules: a self-contained HTML fragment (no <html>/<head>), inline <style> allowed; no external resources (images, fonts, scripts, links to URLs are blocked); images only as inline SVG or data: URLs.",
+        "Style with the CSS variables provided: var(--background), var(--foreground), var(--muted), var(--muted-foreground), var(--card), var(--border), var(--primary), var(--primary-foreground), var(--destructive), var(--radius). They follow the app's light/dark theme; do not hardcode colours.",
+        "The chat already draws the card frame (border, background, padding, title): do NOT add an outer border, background, shadow or padding of your own; start with the content. Use var(--destructive) only for errors or overdue items, var(--primary) for the one figure that matters.",
+        "Only show data you got from tools or the user. Keep the card compact. Write a short sentence in the chat too.",
+    ].join(" "),
+    input: z.object({
+        title: z.string().trim().min(1).max(AI_CARD_TITLE_MAX).optional(),
+        html: z.string().min(1).max(AI_CARD_HTML_MAX),
+    }),
+    permission: AiPermissions.use,
+    handler: async (_ctx, input) => ({ shown: true, bytes: input.html.length }),
+});
+/** Tools for showing things to the user. Add to an agent: `tools: [...financeTools, ...displayTools]`. */
+export const displayTools = [showCardTool];
+//# sourceMappingURL=display.js.map

package/dist/ai/display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../src/ai/display.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,0EAA0E;AAC1E,EAAE;AACF,+EAA+E;AAC/E,iFAAiF;AACjF,gFAAgF;AAChF,+EAA+E;AAC/E,0DAA0D;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC,cAAc,WAAW,CAAA;AAEzB,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAA;AAE1C,2FAA2F;AAC3F,MAAM,CAAC,MAAM,YAAY,GAAG,YAAY,CAAC;IACvC,EAAE,EAAE,YAAY;IAChB,WAAW,EAAE;QACX,kEAAkE;QAClE,mLAAmL;QACnL,uMAAuM;QACvM,gSAAgS;QAChS,qRAAqR;QACrR,+GAA+G;KAChH,CAAC,IAAI,CAAC,GAAG,CAAC;IACX,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;QACjE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC;KAC9C,CAAC;IACF,UAAU,EAAE,aAAa,CAAC,GAAG;IAC7B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;CAC5E,CAAC,CAAA;AAEF,0GAA0G;AAC1G,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,YAAY,CAAU,CAAA"}

package/dist/ai/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./contract.js";
+export * from "./manifest.js";
+export { defineAiTool, defineAiAgent, executeAiTool } from "./tools.js";
+export { defineAi, type AiSystem } from "./api.js";
+export { AI_SHOW_CARD, showCardTool, displayTools } from "./display.js";
+export * from "./card.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAGA,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AACvE,OAAO,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AACvE,cAAc,WAAW,CAAA"}

package/dist/ai/index.js

@@ -0,0 +1,10 @@
+// `@digimuza/system-core/ai`: reusable AI chat with permissioned tools.
+// Convex default runtime + browser types. The Mastra runner is in
+// `@digimuza/system-core/ai/runner` (Node only, "use node").
+export * from "./contract.js";
+export * from "./manifest.js";
+export { defineAiTool, defineAiAgent, executeAiTool } from "./tools.js";
+export { defineAi } from "./api.js";
+export { AI_SHOW_CARD, showCardTool, displayTools } from "./display.js";
+export * from "./card.js";
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,kEAAkE;AAClE,6DAA6D;AAC7D,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AACvE,OAAO,EAAE,QAAQ,EAAiB,MAAM,UAAU,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AACvE,cAAc,WAAW,CAAA"}

package/dist/ai/manifest.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The AI assistant module. Business module: registers disabled, a Super
+ * enables it. `ai:chat:use` lets a person chat; what the assistant may *do* is
+ * decided per tool by that tool's own permission (finance:invoice:read, …).
+ */
+export declare const ai: {
+    readonly id: "ai";
+    readonly kind: "business";
+    readonly description: "AI asistentas su įrankiais";
+    readonly permissions: readonly {
+        readonly id: "ai:chat:use";
+        readonly name: "Naudoti asistentą";
+        readonly description: "Kalbėtis su AI asistentu ir matyti savo pokalbius";
+    }[];
+    readonly initialSubroles: readonly {
+        readonly id: "ai:user";
+        readonly name: "Asistento naudotojas";
+        readonly description: "Gali kalbėtis su AI asistentu";
+        readonly permissions: readonly "ai:chat:use"[];
+    }[];
+};
+export declare const AiPermissions: {
+    readonly use: "ai:chat:use";
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/ai/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/ai/manifest.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;CAMb,CAAA;AAEF,eAAO,MAAM,aAAa;kBAAU,aAAa;CAA6D,CAAA"}

package/dist/ai/manifest.js

@@ -0,0 +1,15 @@
+import { defineModule } from "../modules/index.js";
+/**
+ * The AI assistant module. Business module: registers disabled, a Super
+ * enables it. `ai:chat:use` lets a person chat; what the assistant may *do* is
+ * decided per tool by that tool's own permission (finance:invoice:read, …).
+ */
+export const ai = defineModule({
+    id: "ai",
+    kind: "business",
+    description: "AI asistentas su įrankiais",
+    permissions: [{ id: "ai:chat:use", name: "Naudoti asistentą", description: "Kalbėtis su AI asistentu ir matyti savo pokalbius" }],
+    initialSubroles: [{ id: "ai:user", name: "Asistento naudotojas", description: "Gali kalbėtis su AI asistentu", permissions: ["ai:chat:use"] }],
+});
+export const AiPermissions = { use: "ai:chat:use" };
+//# sourceMappingURL=manifest.js.map