@oddkin/ai 0.0.0-stage → 1.0.0-beta.1

package/dist/task-plan/task-plan.recipe.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const taskPlanRecipeStyles: import("@oddkin/core/styles").CSSResult;
+//# sourceMappingURL=task-plan.recipe.styles.d.ts.map

package/dist/task-plan/task-plan.recipe.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-plan.recipe.styles.d.ts","sourceRoot":"","sources":["../../src/task-plan/task-plan.recipe.styles.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,yCAEhC,CAAC"}

package/dist/task-plan/task-plan.recipe.styles.js

@@ -0,0 +1,5 @@
+// Generated from ./task-plan.recipe.ts by packages/ai/test/recipes.test.ts (UPDATE_FIXTURES=1).
+// Do not edit: change the recipe and regenerate.
+import { unsafeCSS } from '@oddkin/core/styles';
+export const taskPlanRecipeStyles = unsafeCSS('@layer odd.layout.base {\n  .base {\n    display: flex;\n    flex-direction: column;\n    gap: var(--odd-space-sm);\n    min-inline-size: 0;\n  }\n  .progress {\n    display: flex;\n    flex-direction: row;\n    align-items: center;\n    gap: var(--odd-space-xs);\n    flex-wrap: wrap;\n    min-inline-size: 0;\n  }\n  .steps {\n    display: flex;\n    flex-direction: column;\n    gap: var(--odd-space-xs);\n    min-inline-size: 0;\n  }\n  .tasks {\n    display: flex;\n    flex-direction: column;\n    gap: var(--odd-space-xs);\n    min-inline-size: 0;\n  }\n  .step {\n    display: flex;\n    flex-direction: row;\n    align-items: baseline;\n    gap: var(--odd-space-xs);\n    flex-wrap: nowrap;\n    min-inline-size: 0;\n  }\n  .task {\n    display: flex;\n    flex-direction: row;\n    align-items: baseline;\n    gap: var(--odd-space-xs);\n    flex-wrap: nowrap;\n    min-inline-size: 0;\n  }\n  .body {\n    display: flex;\n    flex-direction: column;\n    gap: 0.125rem;\n    min-inline-size: 0;\n  }\n}\n');
+//# sourceMappingURL=task-plan.recipe.styles.js.map

package/dist/task-plan/task-plan.recipe.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-plan.recipe.styles.js","sourceRoot":"","sources":["../../src/task-plan/task-plan.recipe.styles.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,iDAAiD;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAC3C,w/BAAw/B,CACz/B,CAAC"}

package/dist/task-plan/task-plan.styles.d.ts

@@ -0,0 +1,3 @@
+/** The arrangement is the layout recipe in `task-plan.recipe.ts`. */
+export declare const taskPlanStyles: import("@oddkin/core/styles").CSSResult;
+//# sourceMappingURL=task-plan.styles.d.ts.map

package/dist/task-plan/task-plan.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-plan.styles.d.ts","sourceRoot":"","sources":["../../src/task-plan/task-plan.styles.ts"],"names":[],"mappings":"AAIA,qEAAqE;AACrE,eAAO,MAAM,cAAc,yCA8C1B,CAAC"}

package/dist/task-plan/task-plan.styles.js

@@ -0,0 +1,52 @@
+import { css } from '@oddkin/core/styles';
+import { token } from '@oddkin/tokens/refs';
+import { taskPlanRecipeStyles } from './task-plan.recipe.styles.js';
+/** The arrangement is the layout recipe in `task-plan.recipe.ts`. */
+export const taskPlanStyles = css `
+  ${taskPlanRecipeStyles}
+  .title {
+    margin: 0;
+    font-weight: ${token('font.weight.semibold')};
+  }
+  progress {
+    inline-size: min(100%, 16rem);
+  }
+  .steps,
+  .tasks {
+    margin: 0;
+    padding: 0;
+    list-style: none;
+  }
+  .task {
+    font-size: ${token('font.size.sm')};
+  }
+  .symbol {
+    inline-size: 1.25em;
+    flex: none;
+    text-align: center;
+    color: ${token('color.text.secondary')};
+  }
+  [data-status='done'] > .symbol {
+    color: ${token('color.success.foreground')};
+  }
+  [data-status='failed'] > .symbol,
+  [data-status='blocked'] > .symbol {
+    color: ${token('color.danger.foreground')};
+  }
+  [data-status='active'] > .body > .step-title,
+  [data-status='needs-input'] > .body > .step-title {
+    font-weight: ${token('font.weight.semibold')};
+  }
+  .detail,
+  .request {
+    font-size: ${token('font.size.sm')};
+  }
+  .parallel {
+    margin: ${token('space.2xs')} 0 0;
+  }
+  .tasks {
+    padding-inline-start: ${token('space.xs')};
+    border-inline-start: ${token('border.width.default')} solid ${token('color.border.default')};
+  }
+`;
+//# sourceMappingURL=task-plan.styles.js.map

package/dist/task-plan/task-plan.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-plan.styles.js","sourceRoot":"","sources":["../../src/task-plan/task-plan.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,qEAAqE;AACrE,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAA;IAC7B,oBAAoB;;;mBAGL,KAAK,CAAC,sBAAsB,CAAC;;;;;;;;;;;;iBAY/B,KAAK,CAAC,cAAc,CAAC;;;;;;aAMzB,KAAK,CAAC,sBAAsB,CAAC;;;aAG7B,KAAK,CAAC,0BAA0B,CAAC;;;;aAIjC,KAAK,CAAC,yBAAyB,CAAC;;;;mBAI1B,KAAK,CAAC,sBAAsB,CAAC;;;;iBAI/B,KAAK,CAAC,cAAc,CAAC;;;cAGxB,KAAK,CAAC,WAAW,CAAC;;;4BAGJ,KAAK,CAAC,UAAU,CAAC;2BAClB,KAAK,CAAC,sBAAsB,CAAC,UAAU,KAAK,CAAC,sBAAsB,CAAC;;CAE9F,CAAC"}

package/dist/task-plan/task-plan.template.d.ts

@@ -0,0 +1,4 @@
+import type { OddkinTaskPlan } from './task-plan.js';
+/** Anatomy: a title, `progress`, and the `steps` list with nested parallel tasks. */
+export declare const taskPlanTemplate: (host: OddkinTaskPlan) => import("@oddkin/core/template").TemplateResult;
+//# sourceMappingURL=task-plan.template.d.ts.map

package/dist/task-plan/task-plan.template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-plan.template.d.ts","sourceRoot":"","sources":["../../src/task-plan/task-plan.template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,SAAU,cAAc,mDAqEpD,CAAC"}

package/dist/task-plan/task-plan.template.js

@@ -0,0 +1,63 @@
+import { html, repeat } from '@oddkin/core/template';
+import { format } from '../internal/strings.js';
+/** Anatomy: a title, `progress`, and the `steps` list with nested parallel tasks. */
+export const taskPlanTemplate = (host) => {
+    const t = host._strings;
+    const plan = host.plan;
+    if (!plan)
+        return html ``;
+    const { done, total } = host._progress();
+    const progressText = format(t.progress, { done, total });
+    return html `<section class="base" part="base" aria-labelledby="title">
+    <p id="title" class="title">${plan.title || t.label}</p>
+    <div part="progress" class="progress">
+      <progress .max=${Math.max(total, 1)} .value=${done} aria-label=${progressText}></progress>
+      <span class="muted">${progressText}</span>
+    </div>
+    <ol part="steps" class="steps">
+      ${repeat(plan.steps, (step) => step.id, (step) => html `<li class="step" data-status=${step.status}>
+            <span class="symbol" aria-hidden="true">${host._symbol(step.status)}</span>
+            <div class="body">
+              <span class="step-title">${step.title}</span>
+              <span class="visually-hidden">, ${host._status(step.status, step.blocker)}</span>
+              <span class="muted" aria-hidden="true"
+                >${host._status(step.status, step.blocker)}</span
+              >
+              <span class="detail" ?hidden=${!step.detail}>${step.detail ?? ''}</span>
+              ${step.status === 'needs-input' && step.inputRequest
+        ? html `<span class="request"
+                      >${format(t.needsInput, { request: step.inputRequest })}
+                      <button
+                        class="text-button"
+                        type="button"
+                        data-step=${step.id}
+                        @click=${host._respond}
+                      >
+                        ${t.respond}
+                      </button></span
+                    >`
+        : null}
+              ${step.tasks?.length
+        ? html `<p class="muted parallel">${t.parallel}</p>
+                      <ul class="tasks">
+                        ${step.tasks.map((task) => html `<li class="task" data-status=${task.status}>
+                              <span class="symbol" aria-hidden="true"
+                                >${host._symbol(task.status)}</span
+                              >
+                              <span
+                                >${task.title}<span class="visually-hidden"
+                                  >, ${host._status(task.status)}</span
+                                ></span
+                              >
+                              <span class="muted" aria-hidden="true"
+                                >${host._status(task.status)}</span
+                              >
+                            </li>`)}
+                      </ul>`
+        : null}
+            </div>
+          </li>`)}
+    </ol>
+  </section>`;
+};
+//# sourceMappingURL=task-plan.template.js.map

package/dist/task-plan/task-plan.template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-plan.template.js","sourceRoot":"","sources":["../../src/task-plan/task-plan.template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGhD,qFAAqF;AACrF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAoB,EAAE,EAAE;IACvD,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;IACxB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA,EAAE,CAAC;IACzB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,OAAO,IAAI,CAAA;kCACqB,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK;;uBAEhC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,WAAW,IAAI,eAAe,YAAY;4BACvD,YAAY;;;QAGhC,MAAM,CACN,IAAI,CAAC,KAAK,EACV,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EACjB,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAA,gCAAgC,IAAI,CAAC,MAAM;sDACH,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;;yCAEtC,IAAI,CAAC,KAAK;gDACH,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC;;mBAEpE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC;;6CAEb,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE;gBAE9D,IAAI,CAAC,MAAM,KAAK,aAAa,IAAI,IAAI,CAAC,YAAY;QAChD,CAAC,CAAC,IAAI,CAAA;yBACC,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;;;;oCAIzC,IAAI,CAAC,EAAE;iCACV,IAAI,CAAC,QAAQ;;0BAEpB,CAAC,CAAC,OAAO;;sBAEb;QACJ,CAAC,CAAC,IACN;gBAEE,IAAI,CAAC,KAAK,EAAE,MAAM;QAChB,CAAC,CAAC,IAAI,CAAA,6BAA6B,CAAC,CAAC,QAAQ;;0BAErC,IAAI,CAAC,KAAK,CAAC,GAAG,CACd,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAA,gCAAgC,IAAI,CAAC,MAAM;;mCAExC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;;;mCAGzB,IAAI,CAAC,KAAK;uCACN,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;;;;mCAI7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;;kCAE1B,CACT;4BACG;QACV,CAAC,CAAC,IACN;;gBAEE,CACT;;aAEM,CAAC;AACd,CAAC,CAAC"}

package/dist/tool-call/index.d.ts

@@ -0,0 +1,6 @@
+export { OddkinToolCall, TOOL_CALL_STRINGS } from './tool-call.js';
+export type { ToolOutputRenderer } from './tool-call.js';
+export { toolCallTemplate } from './tool-call.template.js';
+export { toolCallStyles } from './tool-call.styles.js';
+export { toolCallDefinition } from './tool-call.definition.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tool-call/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tool-call/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/tool-call/index.js

@@ -0,0 +1,6 @@
+// Side-effect free. Register with `@oddkin/ai/define/tool-call`.
+export { OddkinToolCall, TOOL_CALL_STRINGS } from './tool-call.js';
+export { toolCallTemplate } from './tool-call.template.js';
+export { toolCallStyles } from './tool-call.styles.js';
+export { toolCallDefinition } from './tool-call.definition.js';
+//# sourceMappingURL=index.js.map

package/dist/tool-call/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tool-call/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/tool-call/tool-call.d.ts

@@ -0,0 +1,187 @@
+import { OddkinElement, type ElementEvents } from '@oddkin/core/element';
+import type { ToolCallRecord } from '../contracts/types.js';
+export declare const TOOL_CALL_STRINGS: {
+    'input-streaming': string;
+    'input-available': string;
+    'awaiting-approval': string;
+    executing: string;
+    'output-available': string;
+    'output-error': string;
+    denied: string;
+    cancelled: string;
+    arguments: string;
+    result: string;
+    error: string;
+    retry: string;
+    details: string;
+};
+/** Render a tool result; return undefined to fall back to the JSON view. Output is untrusted. */
+export type ToolOutputRenderer = (tool: ToolCallRecord) => Node | undefined;
+declare const OddkinToolCall_base: import("@oddkin/core/element").WithProps<typeof OddkinElement, {
+    readonly tool: import("@oddkin/core/element").PropDefinition<{
+        approvalId?: string | undefined;
+        attemptId?: string | undefined;
+        error?: {
+            code: string;
+            message: string;
+            retryable?: boolean | undefined;
+        } | undefined;
+        input?: import("../contracts/types.js").JsonValue | undefined;
+        inputText?: string | undefined;
+        output?: import("../contracts/types.js").JsonValue | undefined;
+        purpose?: string | undefined;
+        retryable?: boolean | undefined;
+        status: "awaiting-approval" | "cancelled" | "denied" | "executing" | "input-available" | "input-streaming" | "output-available" | "output-error";
+        title?: string | undefined;
+        toolCallId: string;
+        toolName: string;
+    } | undefined>;
+    readonly approval: import("@oddkin/core/element").PropDefinition<{
+        approvalId: string;
+        attemptId?: string | undefined;
+        changes?: {
+            after?: string | undefined;
+            before?: string | undefined;
+            label: string;
+        }[] | undefined;
+        decision?: "approve" | "reject" | undefined;
+        error?: {
+            code: string;
+            message: string;
+            retryable?: boolean | undefined;
+        } | undefined;
+        expiresAt?: string | undefined;
+        reason?: string | undefined;
+        revision: number;
+        risk?: "high" | "low" | "medium" | undefined;
+        status: "approved" | "decision-failed" | "decision-pending" | "expired" | "rejected" | "requested" | "superseded";
+        summary?: string | undefined;
+        target?: string | undefined;
+        title: string;
+        toolCallId?: string | undefined;
+    } | undefined>;
+    readonly capabilities: import("@oddkin/core/element").PropDefinition<{
+        attachments?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        disconnect?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        edit?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        editApproval?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        feedback?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        history?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        reconnect?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        regenerate?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        respondToApproval?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        restoreCheckpoint?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        resume?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        retry?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        send?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        stop?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        switchBranch?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+        voice?: {
+            available: boolean;
+            reason?: string | undefined;
+        } | undefined;
+    } | undefined>;
+    readonly renderOutput: import("@oddkin/core/element").PropDefinition<{
+        render: ToolOutputRenderer;
+    } | undefined>;
+    readonly strings: import("@oddkin/core/element").PropDefinition<Partial<{
+        'input-streaming': string;
+        'input-available': string;
+        'awaiting-approval': string;
+        executing: string;
+        'output-available': string;
+        'output-error': string;
+        denied: string;
+        cancelled: string;
+        arguments: string;
+        result: string;
+        error: string;
+        retry: string;
+        details: string;
+    }> | undefined>;
+}>;
+/**
+ * One tool call: identity, purpose, streamed arguments, execution state, result or failure, and
+ * the recovery actions the host supports. Argument generation, approval, and execution are
+ * shown as distinct states; complete arguments never read as success.
+ *
+ * @csspart base - The tool call surface.
+ * @csspart summary - Name, purpose, and status (a native disclosure summary).
+ * @csspart arguments - Streamed or complete arguments.
+ * @csspart result - Result or error.
+ * @a11y Status is text, not colour alone. Details use a native disclosure; its open state is local presentation state the element never overrides.
+ * @keyboard Enter or Space toggles the details.
+ * @useFor Showing what an agent or model asked a tool to do, and what happened.
+ * @notFor Arbitrary log output.
+ * @limitation Results render as formatted JSON text unless a host `renderOutput` returns a node.
+ * @customization 1 2
+ * @category AI
+ */
+export declare class OddkinToolCall extends OddkinToolCall_base {
+    static events: {
+        'odd-tool-retry': import("@oddkin/core/element").EventDefinition<{
+            readonly toolCallId: string;
+        }>;
+    };
+    readonly _events?: ElementEvents<typeof OddkinToolCall>;
+    /** @internal */
+    get _strings(): typeof TOOL_CALL_STRINGS;
+    /** @internal */
+    readonly _retry: () => void;
+    /** @internal Formatted arguments: streamed text while generating, then the parsed input. */
+    _arguments(): string;
+    /** @internal */
+    _output(): Node | string | undefined;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'odd-tool-call': OddkinToolCall;
+    }
+}
+export {};
+//# sourceMappingURL=tool-call.d.ts.map

package/dist/tool-call/tool-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.d.ts","sourceRoot":"","sources":["../../src/tool-call/tool-call.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAQ,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,KAAK,EAAgC,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI1F,eAAO,MAAM,iBAAiB;IAC5B,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,SAAS;IACT,kBAAkB;IAClB,cAAc;IACd,MAAM;IACN,SAAS;IACT,SAAS;IACT,MAAM;IACN,KAAK;IACL,KAAK;IACL,OAAO;CACR,CAAC;AAEF,iGAAiG;AACjG,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,GAAG,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAyBtC,kBAAkB;;;;;;;;;;;;;;;;;;AAvBxD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAe,SAAQ,mBAYlC;IACA,OAAgB,MAAM;QAAK,gBAAgB;;;MAAmB;IAC9D,SAAiB,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,cAAc,CAAC,CAAC;IAEhE,gBAAgB;IAChB,IAAI,QAAQ,IAAI,OAAO,iBAAiB,CAEvC;IAED,gBAAgB;IAChB,QAAQ,CAAC,MAAM,QAAO,IAAI,CAIxB;IAEF,4FAA4F;IAC5F,UAAU,IAAI,MAAM,CAKnB;IAED,gBAAgB;IAChB,OAAO,IAAI,IAAI,GAAG,MAAM,GAAG,SAAS,CAInC;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,eAAe,EAAE,cAAc,CAAC;KACjC;CACF"}

package/dist/tool-call/tool-call.define.d.ts

@@ -0,0 +1,3 @@
+/// <reference path="tool-call.d.ts" preserve="true" />
+export {};
+//# sourceMappingURL=tool-call.define.d.ts.map

package/dist/tool-call/tool-call.define.d.ts.map

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

package/dist/tool-call/tool-call.define.js

@@ -0,0 +1,5 @@
+/// <reference path="./tool-call.ts" preserve="true" />
+import { define } from '@oddkin/core/element';
+import { toolCallDefinition } from './tool-call.definition.js';
+define(toolCallDefinition);
+//# sourceMappingURL=tool-call.define.js.map

package/dist/tool-call/tool-call.define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.define.js","sourceRoot":"","sources":["../../src/tool-call/tool-call.define.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/tool-call/tool-call.definition.d.ts

@@ -0,0 +1,3 @@
+import { OddkinToolCall } from './tool-call.js';
+export declare const toolCallDefinition: import("@oddkin/core/element").ElementDefinition<OddkinToolCall>;
+//# sourceMappingURL=tool-call.definition.d.ts.map

package/dist/tool-call/tool-call.definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.definition.d.ts","sourceRoot":"","sources":["../../src/tool-call/tool-call.definition.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIhD,eAAO,MAAM,kBAAkB,kEAM7B,CAAC"}

package/dist/tool-call/tool-call.definition.js

@@ -0,0 +1,14 @@
+import { compose } from '@oddkin/core/element';
+import { actionApprovalDefinition } from '../action-approval/action-approval.definition.js';
+import { aiBaseStyles } from '../internal/base.styles.js';
+import { OddkinToolCall } from './tool-call.js';
+import { toolCallStyles } from './tool-call.styles.js';
+import { toolCallTemplate } from './tool-call.template.js';
+export const toolCallDefinition = compose({
+    name: 'odd-tool-call',
+    element: OddkinToolCall,
+    template: toolCallTemplate,
+    styles: [aiBaseStyles, toolCallStyles],
+    dependencies: { approval: actionApprovalDefinition },
+});
+//# sourceMappingURL=tool-call.definition.js.map

package/dist/tool-call/tool-call.definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.definition.js","sourceRoot":"","sources":["../../src/tool-call/tool-call.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,kDAAkD,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;IACxC,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,gBAAgB;IAC1B,MAAM,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC;IACtC,YAAY,EAAE,EAAE,QAAQ,EAAE,wBAAwB,EAAE;CACrD,CAAC,CAAC"}

package/dist/tool-call/tool-call.js

@@ -0,0 +1,77 @@
+import { OddkinElement, prop } from '@oddkin/core/element';
+import { toolRetryEvent } from '../events.js';
+import { strings } from '../internal/strings.js';
+export const TOOL_CALL_STRINGS = {
+    'input-streaming': 'Preparing arguments…',
+    'input-available': 'Arguments ready; not run yet',
+    'awaiting-approval': 'Waiting for approval',
+    executing: 'Running…',
+    'output-available': 'Finished',
+    'output-error': 'Failed',
+    denied: 'Not run: denied',
+    cancelled: 'Cancelled',
+    arguments: 'Arguments',
+    result: 'Result',
+    error: 'Error',
+    retry: 'Retry',
+    details: 'Details',
+};
+/**
+ * One tool call: identity, purpose, streamed arguments, execution state, result or failure, and
+ * the recovery actions the host supports. Argument generation, approval, and execution are
+ * shown as distinct states; complete arguments never read as success.
+ *
+ * @csspart base - The tool call surface.
+ * @csspart summary - Name, purpose, and status (a native disclosure summary).
+ * @csspart arguments - Streamed or complete arguments.
+ * @csspart result - Result or error.
+ * @a11y Status is text, not colour alone. Details use a native disclosure; its open state is local presentation state the element never overrides.
+ * @keyboard Enter or Space toggles the details.
+ * @useFor Showing what an agent or model asked a tool to do, and what happened.
+ * @notFor Arbitrary log output.
+ * @limitation Results render as formatted JSON text unless a host `renderOutput` returns a node.
+ * @customization 1 2
+ * @category AI
+ */
+export class OddkinToolCall extends OddkinElement.with({
+    tool: prop.object({ description: 'The tool call record.' }),
+    approval: prop.object({
+        description: 'Approval bound to this call, when one was requested.',
+    }),
+    capabilities: prop.object({ description: 'Passed to the nested approval.' }),
+    renderOutput: prop.object({
+        description: 'Host renderer for results (`{ render(tool) }`).',
+    }),
+    strings: prop.object({
+        description: 'Localized string overrides.',
+    }),
+}) {
+    static events = { 'odd-tool-retry': toolRetryEvent };
+    /** @internal */
+    get _strings() {
+        return strings(TOOL_CALL_STRINGS, this.strings);
+    }
+    /** @internal */
+    _retry = () => {
+        const tool = this.tool;
+        if (tool?.status === 'output-error' && tool.retryable)
+            this.emit(toolRetryEvent, { toolCallId: tool.toolCallId });
+    };
+    /** @internal Formatted arguments: streamed text while generating, then the parsed input. */
+    _arguments() {
+        const tool = this.tool;
+        if (!tool)
+            return '';
+        if (tool.input !== undefined)
+            return JSON.stringify(tool.input, null, 2);
+        return tool.inputText ?? '';
+    }
+    /** @internal */
+    _output() {
+        const tool = this.tool;
+        if (!tool || tool.output === undefined)
+            return undefined;
+        return this.renderOutput?.render(tool) ?? JSON.stringify(tool.output, null, 2);
+    }
+}
+//# sourceMappingURL=tool-call.js.map

package/dist/tool-call/tool-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.js","sourceRoot":"","sources":["../../src/tool-call/tool-call.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,IAAI,EAAsB,MAAM,sBAAsB,CAAC;AAE/E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,iBAAiB,EAAE,sBAAsB;IACzC,iBAAiB,EAAE,8BAA8B;IACjD,mBAAmB,EAAE,sBAAsB;IAC3C,SAAS,EAAE,UAAU;IACrB,kBAAkB,EAAE,UAAU;IAC9B,cAAc,EAAE,QAAQ;IACxB,MAAM,EAAE,iBAAiB;IACzB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;CACnB,CAAC;AAKF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,cAAe,SAAQ,aAAa,CAAC,IAAI,CAAC;IACrD,IAAI,EAAE,IAAI,CAAC,MAAM,CAAiB,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC;IAC3E,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAiB;QACpC,WAAW,EAAE,sDAAsD;KACpE,CAAC;IACF,YAAY,EAAE,IAAI,CAAC,MAAM,CAAe,EAAE,WAAW,EAAE,gCAAgC,EAAE,CAAC;IAC1F,YAAY,EAAE,IAAI,CAAC,MAAM,CAAiC;QACxD,WAAW,EAAE,iDAAiD;KAC/D,CAAC;IACF,OAAO,EAAE,IAAI,CAAC,MAAM,CAAoC;QACtD,WAAW,EAAE,6BAA6B;KAC3C,CAAC;CACH,CAAC;IACA,MAAM,CAAU,MAAM,GAAG,EAAE,gBAAgB,EAAE,cAAc,EAAE,CAAC;IAG9D,gBAAgB;IAChB,IAAI,QAAQ;QACV,OAAO,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,gBAAgB;IACP,MAAM,GAAG,GAAS,EAAE;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,IAAI,EAAE,MAAM,KAAK,cAAc,IAAI,IAAI,CAAC,SAAS;YACnD,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAC/D,CAAC,CAAC;IAEF,4FAA4F;IAC5F,UAAU;QACR,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QACrB,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,gBAAgB;IAChB,OAAO;QACL,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACzD,OAAO,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACjF,CAAC;CACF"}

package/dist/tool-call/tool-call.recipe.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Arrangement of the tool call (layout-recipes.md §14): the summary and the failure line in
+ * centred rows that wrap, the body's input and output stacked. The host stacks the call and its
+ * approval itself: a region is a class, and the host has none.
+ */
+export declare const toolCallRecipe: import("@oddkin/components/layout").LayoutRecipe;
+//# sourceMappingURL=tool-call.recipe.d.ts.map

package/dist/tool-call/tool-call.recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.recipe.d.ts","sourceRoot":"","sources":["../../src/tool-call/tool-call.recipe.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,cAAc,kDAOzB,CAAC"}

package/dist/tool-call/tool-call.recipe.js

@@ -0,0 +1,16 @@
+import { defineLayoutRecipe, row, stack } from '@oddkin/components/layout';
+import { token } from '@oddkin/tokens/refs';
+/**
+ * Arrangement of the tool call (layout-recipes.md §14): the summary and the failure line in
+ * centred rows that wrap, the body's input and output stacked. The host stacks the call and its
+ * approval itself: a region is a class, and the host has none.
+ */
+export const toolCallRecipe = defineLayoutRecipe({
+    name: 'tool-call',
+    regions: {
+        summary: row({ gap: token('space.xs'), wrap: true }),
+        body: stack({ gap: token('space.xs') }),
+        failure: row({ gap: token('space.xs'), wrap: true }),
+    },
+});
+//# sourceMappingURL=tool-call.recipe.js.map

package/dist/tool-call/tool-call.recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.recipe.js","sourceRoot":"","sources":["../../src/tool-call/tool-call.recipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,kBAAkB,CAAC;IAC/C,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE;QACP,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACpD,IAAI,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;KACrD;CACF,CAAC,CAAC"}

package/dist/tool-call/tool-call.recipe.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const toolCallRecipeStyles: import("@oddkin/core/styles").CSSResult;
+//# sourceMappingURL=tool-call.recipe.styles.d.ts.map

package/dist/tool-call/tool-call.recipe.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.recipe.styles.d.ts","sourceRoot":"","sources":["../../src/tool-call/tool-call.recipe.styles.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,yCAEhC,CAAC"}

package/dist/tool-call/tool-call.recipe.styles.js

@@ -0,0 +1,5 @@
+// Generated from ./tool-call.recipe.ts by packages/ai/test/recipes.test.ts (UPDATE_FIXTURES=1).
+// Do not edit: change the recipe and regenerate.
+import { unsafeCSS } from '@oddkin/core/styles';
+export const toolCallRecipeStyles = unsafeCSS('@layer odd.layout.base {\n  .summary {\n    display: flex;\n    flex-direction: row;\n    align-items: center;\n    gap: var(--odd-space-xs);\n    flex-wrap: wrap;\n    min-inline-size: 0;\n  }\n  .body {\n    display: flex;\n    flex-direction: column;\n    gap: var(--odd-space-xs);\n    min-inline-size: 0;\n  }\n  .failure {\n    display: flex;\n    flex-direction: row;\n    align-items: center;\n    gap: var(--odd-space-xs);\n    flex-wrap: wrap;\n    min-inline-size: 0;\n  }\n}\n');
+//# sourceMappingURL=tool-call.recipe.styles.js.map

package/dist/tool-call/tool-call.recipe.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.recipe.styles.js","sourceRoot":"","sources":["../../src/tool-call/tool-call.recipe.styles.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,iDAAiD;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAC3C,0eAA0e,CAC3e,CAAC"}

package/dist/tool-call/tool-call.styles.d.ts

@@ -0,0 +1,3 @@
+/** The arrangement is the layout recipe in `tool-call.recipe.ts`. */
+export declare const toolCallStyles: import("@oddkin/core/styles").CSSResult;
+//# sourceMappingURL=tool-call.styles.d.ts.map

package/dist/tool-call/tool-call.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.styles.d.ts","sourceRoot":"","sources":["../../src/tool-call/tool-call.styles.ts"],"names":[],"mappings":"AAIA,qEAAqE;AACrE,eAAO,MAAM,cAAc,yCAgD1B,CAAC"}

package/dist/tool-call/tool-call.styles.js

@@ -0,0 +1,54 @@
+import { css } from '@oddkin/core/styles';
+import { token } from '@oddkin/tokens/refs';
+import { toolCallRecipeStyles } from './tool-call.recipe.styles.js';
+/** The arrangement is the layout recipe in `tool-call.recipe.ts`. */
+export const toolCallStyles = css `
+  ${toolCallRecipeStyles}
+  :host {
+    display: grid;
+    gap: ${token('space.xs')};
+  }
+  .base {
+    border: ${token('border.width.default')} solid ${token('color.border.default')};
+    border-radius: ${token('radius.md')};
+    background: ${token('color.surface.default')};
+  }
+  .summary {
+    min-block-size: ${token('target.min')};
+    padding: ${token('space.xs')} ${token('space.sm')};
+    cursor: pointer;
+  }
+  .name {
+    font-family: ${token('font.family.mono')};
+    font-size: ${token('font.size.sm')};
+    font-weight: ${token('font.weight.semibold')};
+  }
+  .purpose {
+    flex-basis: 100%;
+  }
+  .body {
+    padding: 0 ${token('space.sm')} ${token('space.sm')};
+  }
+  .label {
+    margin: 0 0 ${token('space.2xs')};
+    font-size: ${token('font.size.xs')};
+    font-weight: ${token('font.weight.semibold')};
+    color: ${token('color.text.secondary')};
+  }
+  .code {
+    margin: 0;
+    max-block-size: 16rem;
+    padding: ${token('space.xs')};
+    overflow: auto;
+    border-radius: ${token('radius.sm')};
+    background: ${token('color.surface.sunken')};
+    font-family: ${token('font.family.mono')};
+    font-size: ${token('font.size.xs')};
+    white-space: pre-wrap;
+  }
+  .failure {
+    padding: ${token('space.xs')} ${token('space.sm')};
+    border-block-start: ${token('border.width.default')} solid ${token('color.danger.foreground')};
+  }
+`;
+//# sourceMappingURL=tool-call.styles.js.map

package/dist/tool-call/tool-call.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.styles.js","sourceRoot":"","sources":["../../src/tool-call/tool-call.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,qEAAqE;AACrE,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAA;IAC7B,oBAAoB;;;WAGb,KAAK,CAAC,UAAU,CAAC;;;cAGd,KAAK,CAAC,sBAAsB,CAAC,UAAU,KAAK,CAAC,sBAAsB,CAAC;qBAC7D,KAAK,CAAC,WAAW,CAAC;kBACrB,KAAK,CAAC,uBAAuB,CAAC;;;sBAG1B,KAAK,CAAC,YAAY,CAAC;eAC1B,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC;;;;mBAIlC,KAAK,CAAC,kBAAkB,CAAC;iBAC3B,KAAK,CAAC,cAAc,CAAC;mBACnB,KAAK,CAAC,sBAAsB,CAAC;;;;;;iBAM/B,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC;;;kBAGrC,KAAK,CAAC,WAAW,CAAC;iBACnB,KAAK,CAAC,cAAc,CAAC;mBACnB,KAAK,CAAC,sBAAsB,CAAC;aACnC,KAAK,CAAC,sBAAsB,CAAC;;;;;eAK3B,KAAK,CAAC,UAAU,CAAC;;qBAEX,KAAK,CAAC,WAAW,CAAC;kBACrB,KAAK,CAAC,sBAAsB,CAAC;mBAC5B,KAAK,CAAC,kBAAkB,CAAC;iBAC3B,KAAK,CAAC,cAAc,CAAC;;;;eAIvB,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC;0BAC3B,KAAK,CAAC,sBAAsB,CAAC,UAAU,KAAK,CAAC,yBAAyB,CAAC;;CAEhG,CAAC"}