@hanfani/core 0.1.1

package/dist/gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../src/gate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,eAAe,CAAA;AAC9E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,WAAW,EAAG,aAAsB,CAAA;AAEjD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe,CAElE;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,eAAe,GAAG,IAAI,CAKvE"}

package/dist/gate.js

@@ -0,0 +1,22 @@
+import { EventType } from '@ag-ui/client';
+import { z } from 'zod';
+export const GATE_OPENED = 'GATE_OPENED';
+export const GateOpenedValueSchema = z.object({
+    gateKind: z.literal('approval'),
+    toolName: z.string(),
+    toolCallId: z.string(),
+    proposedArtifact: z.record(z.unknown()),
+});
+/** Emit the custom event that opens a human-approval gate. */
+export function gateOpened(value) {
+    return { type: EventType.CUSTOM, name: GATE_OPENED, value };
+}
+/** Read a GATE_OPENED value off an event, or null if it isn't one. */
+export function readGateOpened(event) {
+    const e = event;
+    if (e.type !== EventType.CUSTOM || e.name !== GATE_OPENED)
+        return null;
+    const parsed = GateOpenedValueSchema.safeParse(e.value);
+    return parsed.success ? parsed.data : null;
+}
+//# sourceMappingURL=gate.js.map

package/dist/gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.js","sourceRoot":"","sources":["../src/gate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAEzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,WAAW,GAAG,aAAsB,CAAA;AAEjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;CACxC,CAAC,CAAA;AAGF,8DAA8D;AAC9D,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAqB,CAAA;AAChF,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,KAAgB;IAC7C,MAAM,CAAC,GAAG,KAAwB,CAAA;IAClC,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,IAAI,CAAA;IACtE,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACvD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AAC5C,CAAC"}

package/dist/handoff.d.ts

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+import type { Message, RunAgentInput } from '@ag-ui/client';
+export declare const HandoffPayloadSchema: z.ZodObject<{
+    threadId: z.ZodString;
+    from: z.ZodString;
+    subject: z.ZodString;
+    summary: z.ZodString;
+    category: z.ZodString;
+    priority: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    threadId: string;
+    from: string;
+    subject: string;
+    summary: string;
+    category: string;
+    priority: string;
+}, {
+    threadId: string;
+    from: string;
+    subject: string;
+    summary: string;
+    category: string;
+    priority: string;
+}>;
+export type HandoffPayload = z.infer<typeof HandoffPayloadSchema>;
+export declare const TicketHandoffPayloadSchema: z.ZodObject<{
+    repo: z.ZodString;
+    number: z.ZodNumber;
+    title: z.ZodString;
+    status: z.ZodString;
+    priority: z.ZodString;
+    body: z.ZodString;
+    lastComment: z.ZodNullable<z.ZodObject<{
+        author: z.ZodString;
+        body: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        author: string;
+        body: string;
+    }, {
+        author: string;
+        body: string;
+    }>>;
+    recommendation: z.ZodString;
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    repo: string;
+    number: number;
+    title: string;
+    status: string;
+    priority: string;
+    body: string;
+    lastComment: {
+        author: string;
+        body: string;
+    } | null;
+    recommendation: string;
+    url: string;
+}, {
+    repo: string;
+    number: number;
+    title: string;
+    status: string;
+    priority: string;
+    body: string;
+    lastComment: {
+        author: string;
+        body: string;
+    } | null;
+    recommendation: string;
+    url: string;
+}>;
+export type TicketHandoffPayload = z.infer<typeof TicketHandoffPayloadSchema>;
+/** Encode a payload as a user message that downstream agents can decode. */
+export declare function encodeHandoff(payload: unknown): Message;
+/** Decode the most recent handoff payload in the run input, validated by `schema`. */
+export declare function decodeHandoff<T>(input: RunAgentInput, schema: z.ZodType<T>): T | null;
+//# sourceMappingURL=handoff.d.ts.map

package/dist/handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE3D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;EAO/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAerC,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAI7E,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAMvD;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAcrF"}

package/dist/handoff.js

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+export const HandoffPayloadSchema = z.object({
+    threadId: z.string(),
+    from: z.string(),
+    subject: z.string(),
+    summary: z.string(),
+    category: z.string(),
+    priority: z.string(),
+});
+export const TicketHandoffPayloadSchema = z.object({
+    repo: z.string(),
+    number: z.number(),
+    title: z.string(),
+    status: z.string(),
+    priority: z.string(),
+    body: z.string(),
+    lastComment: z
+        .object({
+        author: z.string(),
+        body: z.string(),
+    })
+        .nullable(),
+    recommendation: z.string(),
+    url: z.string(),
+});
+const HANDOFF_PREFIX = '[handoff]';
+/** Encode a payload as a user message that downstream agents can decode. */
+export function encodeHandoff(payload) {
+    return {
+        id: crypto.randomUUID(),
+        role: 'user',
+        content: `${HANDOFF_PREFIX} ${JSON.stringify(payload)}`,
+    };
+}
+/** Decode the most recent handoff payload in the run input, validated by `schema`. */
+export function decodeHandoff(input, schema) {
+    const messages = input?.messages ?? [];
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const m = messages[i];
+        if (m && m.role === 'user' && typeof m.content === 'string' && m.content.startsWith(HANDOFF_PREFIX)) {
+            try {
+                const parsed = schema.safeParse(JSON.parse(m.content.slice(HANDOFF_PREFIX.length).trim()));
+                return parsed.success ? parsed.data : null;
+            }
+            catch {
+                return null;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=handoff.js.map

package/dist/handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAA;AAGF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC;SACX,MAAM,CAAC;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;SACD,QAAQ,EAAE;IACb,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;CAChB,CAAC,CAAA;AAGF,MAAM,cAAc,GAAG,WAAW,CAAA;AAElC,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,GAAG,cAAc,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE;KACxD,CAAA;AACH,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAI,KAAoB,EAAE,MAAoB;IACzE,MAAM,QAAQ,GAAG,KAAK,EAAE,QAAQ,IAAI,EAAE,CAAA;IACtC,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QACrB,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YACpG,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;gBAC1F,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAA;YACb,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/handoffNote.d.ts

@@ -0,0 +1,11 @@
+import type { BaseEvent } from '@ag-ui/client';
+export interface HandoffNoteValue {
+    kind: 'handoff';
+    targetAgentId: string;
+    childWorkItemId: string;
+    deduped: boolean;
+    at: number;
+}
+/** Emit a handoff note event. */
+export declare function handoffNote(value: HandoffNoteValue): BaseEvent;
+//# sourceMappingURL=handoffNote.d.ts.map

package/dist/handoffNote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoffNote.d.ts","sourceRoot":"","sources":["../src/handoffNote.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,EAAE,EAAE,MAAM,CAAA;CACX;AAED,iCAAiC;AACjC,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,CAE9D"}

package/dist/handoffNote.js

@@ -0,0 +1,6 @@
+import { EventType } from '@ag-ui/client';
+/** Emit a handoff note event. */
+export function handoffNote(value) {
+    return { type: EventType.CUSTOM, name: 'handoff', value };
+}
+//# sourceMappingURL=handoffNote.js.map

package/dist/handoffNote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoffNote.js","sourceRoot":"","sources":["../src/handoffNote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAWzC,iCAAiC;AACjC,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAA0B,CAAA;AACnF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export type { Message, ToolCall } from '@ag-ui/client';
+export { AgentDefinitionSchema, defineAgent, type AgentDefinition, type AgentDefinitionInput, } from './defineAgent.js';
+export { defineWorkflow, instanceId } from './defineWorkflow.js';
+export { definePrompt, type PromptSpec } from './definePrompt.js';
+export { defineProviders } from './providers.js';
+export { composeInstructions } from './prompt.js';
+export { approvalResolved, hasPendingApproval, isAssistant, isToolMessage, lastApprovalArgs, pairToolResults, resolvedApprovalCount, toolCallsOf, type AssistantMessage, type ToolMessage, } from './messages.js';
+export { decodeHandoff, encodeHandoff, HandoffPayloadSchema, TicketHandoffPayloadSchema, type HandoffPayload, type TicketHandoffPayload, } from './handoff.js';
+export { handoffNote, type HandoffNoteValue } from './handoffNote.js';
+export { GATE_OPENED, gateOpened, GateOpenedValueSchema, readGateOpened, type GateOpenedValue, } from './gate.js';
+export { LIFECYCLE_NOTE_TEXT, lifecycleNote, type LifecycleNoteValue } from './lifecycleNote.js';
+export { hasLiveDescendant, lifecycle } from './lifecycle.js';
+export { foldEventsToMessages } from './fold.js';
+export { resolveDelivery } from './delivery.js';
+export { providerConformanceChecks, type ConformanceCheck, type ConformanceScenario, } from './conformance.js';
+export { aggregateHealth, isOk } from './integration.js';
+export { isOAuth2 } from './integrationAuth.js';
+export type { AgentRole, AuthSpec, BatchActionResult, CredentialResolver, DeliveryResult, Destination, EffectFn, GateResolution, HealthCheck, Lifecycle, Outcome, Phase, PromptStrategy, Provider, ProviderConfig, ProviderFactory, ProviderRegistry, ReadResult, ResolvedCredential, ResumeHandle, ResumeOutcome, WorkflowAgent, WorkflowConnection, WorkflowDescriptor, WorkflowInput, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAEtD,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhE,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,0BAA0B,EAC1B,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAErE,OAAO,EACL,WAAW,EACX,UAAU,EACV,qBAAqB,EACrB,cAAc,EACd,KAAK,eAAe,GACrB,MAAM,WAAW,CAAA;AAElB,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAEhG,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,OAAO,EACL,yBAAyB,EACzB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAExD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAE/C,YAAY,EACV,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,QAAQ,EACR,cAAc,EACd,WAAW,EACX,SAAS,EACT,OAAO,EACP,KAAK,EACL,cAAc,EACd,QAAQ,EACR,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,GACd,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,22 @@
+// @hanfani/core — headless engine and types for the Hanfani agent framework.
+//
+// The one invariant this package encodes: an agent proposes, a human approves,
+// the server acts. `defineAgent` refuses any effect that isn't gated behind an
+// approval; the conformance suite proves providers honour that at runtime.
+export { AgentDefinitionSchema, defineAgent, } from './defineAgent.js';
+export { defineWorkflow, instanceId } from './defineWorkflow.js';
+export { definePrompt } from './definePrompt.js';
+export { defineProviders } from './providers.js';
+export { composeInstructions } from './prompt.js';
+export { approvalResolved, hasPendingApproval, isAssistant, isToolMessage, lastApprovalArgs, pairToolResults, resolvedApprovalCount, toolCallsOf, } from './messages.js';
+export { decodeHandoff, encodeHandoff, HandoffPayloadSchema, TicketHandoffPayloadSchema, } from './handoff.js';
+export { handoffNote } from './handoffNote.js';
+export { GATE_OPENED, gateOpened, GateOpenedValueSchema, readGateOpened, } from './gate.js';
+export { LIFECYCLE_NOTE_TEXT, lifecycleNote } from './lifecycleNote.js';
+export { hasLiveDescendant, lifecycle } from './lifecycle.js';
+export { foldEventsToMessages } from './fold.js';
+export { resolveDelivery } from './delivery.js';
+export { providerConformanceChecks, } from './conformance.js';
+export { aggregateHealth, isOk } from './integration.js';
+export { isOAuth2 } from './integrationAuth.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,2EAA2E;AAK3E,OAAO,EACL,qBAAqB,EACrB,WAAW,GAGZ,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhE,OAAO,EAAE,YAAY,EAAmB,MAAM,mBAAmB,CAAA;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,WAAW,GAGZ,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,0BAA0B,GAG3B,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAA;AAErE,OAAO,EACL,WAAW,EACX,UAAU,EACV,qBAAqB,EACrB,cAAc,GAEf,MAAM,WAAW,CAAA;AAElB,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAA2B,MAAM,oBAAoB,CAAA;AAEhG,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,OAAO,EACL,yBAAyB,GAG1B,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAExD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/integration.d.ts

@@ -0,0 +1,9 @@
+import type { HealthCheck } from './types.js';
+/** Narrow a HealthCheck to its ok variant. */
+export declare function isOk(h: HealthCheck): h is {
+    ok: true;
+    detail?: string;
+};
+/** Return the first failing check, or an ok result if all pass. */
+export declare function aggregateHealth(checks: HealthCheck[]): HealthCheck;
+//# sourceMappingURL=integration.d.ts.map

package/dist/integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,8CAA8C;AAC9C,wBAAgB,IAAI,CAAC,CAAC,EAAE,WAAW,GAAG,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAEvE;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,CAKlE"}

package/dist/integration.js

@@ -0,0 +1,13 @@
+/** Narrow a HealthCheck to its ok variant. */
+export function isOk(h) {
+    return h.ok;
+}
+/** Return the first failing check, or an ok result if all pass. */
+export function aggregateHealth(checks) {
+    for (const check of checks) {
+        if (!check.ok)
+            return check;
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=integration.js.map

package/dist/integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.js","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"AAEA,8CAA8C;AAC9C,MAAM,UAAU,IAAI,CAAC,CAAc;IACjC,OAAO,CAAC,CAAC,EAAE,CAAA;AACb,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,EAAE;YAAE,OAAO,KAAK,CAAA;IAC7B,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;AACrB,CAAC"}

package/dist/integrationAuth.d.ts

@@ -0,0 +1,8 @@
+import type { AuthSpec } from './types.js';
+/** Narrow an AuthSpec to its oauth2 variant. */
+export declare function isOAuth2(auth: AuthSpec): auth is {
+    kind: 'oauth2';
+    provider: string;
+    scopes: string[];
+};
+//# sourceMappingURL=integrationAuth.d.ts.map

package/dist/integrationAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrationAuth.d.ts","sourceRoot":"","sources":["../src/integrationAuth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C,gDAAgD;AAChD,wBAAgB,QAAQ,CACtB,IAAI,EAAE,QAAQ,GACb,IAAI,IAAI;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAEhE"}

package/dist/integrationAuth.js

@@ -0,0 +1,5 @@
+/** Narrow an AuthSpec to its oauth2 variant. */
+export function isOAuth2(auth) {
+    return auth.kind === 'oauth2';
+}
+//# sourceMappingURL=integrationAuth.js.map

package/dist/integrationAuth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrationAuth.js","sourceRoot":"","sources":["../src/integrationAuth.ts"],"names":[],"mappings":"AAEA,gDAAgD;AAChD,MAAM,UAAU,QAAQ,CACtB,IAAc;IAEd,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAA;AAC/B,CAAC"}

package/dist/lifecycle.d.ts

@@ -0,0 +1,16 @@
+import type { Lifecycle, Outcome, Phase } from './types.js';
+/**
+ * Derive display lifecycle from a work item's phase/outcome plus whether it has
+ * a render card and whether it has a live descendant.
+ */
+export declare function lifecycle(phase: Phase, outcome: Outcome, hasCard: boolean, hasLiveDescendant: boolean): Lifecycle;
+/**
+ * Given flat parent/child rows, return the set of ids that have at least one
+ * live descendant (a queued/active/awaiting_human node somewhere below them).
+ */
+export declare function hasLiveDescendant<T extends {
+    id: string;
+    parentId: string | null;
+    phase: Phase;
+}>(rows: readonly T[]): Set<string>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAO3D;;;GAGG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,iBAAiB,EAAE,OAAO,GACzB,SAAS,CASX;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,EAC/F,IAAI,EAAE,SAAS,CAAC,EAAE,GACjB,GAAG,CAAC,MAAM,CAAC,CA2Bb"}

package/dist/lifecycle.js

@@ -0,0 +1,57 @@
+const LIVE_PHASES = new Set(['queued', 'active', 'awaiting_human']);
+const SILENT_OUTCOMES = new Set(['superseded', 'reset', 'dismissed']);
+const FAILED_OUTCOMES = new Set(['stopped', 'rejected', 'error']);
+const COVERING_OUTCOMES = new Set(['done', 'stopped', 'rejected']);
+/**
+ * Derive display lifecycle from a work item's phase/outcome plus whether it has
+ * a render card and whether it has a live descendant.
+ */
+export function lifecycle(phase, outcome, hasCard, hasLiveDescendant) {
+    const isLive = LIVE_PHASES.has(phase);
+    let isVisible;
+    if (phase === 'queued')
+        isVisible = false;
+    else if (isLive)
+        isVisible = true;
+    else if (SILENT_OUTCOMES.has(outcome))
+        isVisible = false;
+    else
+        isVisible = hasCard || FAILED_OUTCOMES.has(outcome) || hasLiveDescendant;
+    const covers = isLive || COVERING_OUTCOMES.has(outcome);
+    return { phase, outcome, isLive, isVisible, covers };
+}
+/**
+ * Given flat parent/child rows, return the set of ids that have at least one
+ * live descendant (a queued/active/awaiting_human node somewhere below them).
+ */
+export function hasLiveDescendant(rows) {
+    const childrenByParent = new Map();
+    for (const row of rows) {
+        if (!row.parentId)
+            continue;
+        const siblings = childrenByParent.get(row.parentId) ?? [];
+        siblings.push(row);
+        childrenByParent.set(row.parentId, siblings);
+    }
+    const memo = new Map();
+    const visit = (id) => {
+        const cached = memo.get(id);
+        if (cached !== undefined)
+            return cached;
+        memo.set(id, false); // guard against cycles
+        let live = false;
+        for (const child of childrenByParent.get(id) ?? []) {
+            if (LIVE_PHASES.has(child.phase) || visit(child.id))
+                live = true;
+        }
+        memo.set(id, live);
+        return live;
+    };
+    const result = new Set();
+    for (const row of rows) {
+        if (visit(row.id))
+            result.add(row.id);
+    }
+    return result;
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

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

package/dist/lifecycleNote.d.ts

@@ -0,0 +1,13 @@
+import type { BaseEvent } from '@ag-ui/client';
+import type { Outcome } from './types.js';
+export interface LifecycleNoteValue {
+    kind: 'lifecycle';
+    outcome: Outcome;
+    actor: string | null;
+    at: number;
+}
+/** Emit a lifecycle note event. */
+export declare function lifecycleNote(value: LifecycleNoteValue): BaseEvent;
+/** Human-readable label shown for each terminal outcome. */
+export declare const LIFECYCLE_NOTE_TEXT: Record<Outcome, string>;
+//# sourceMappingURL=lifecycleNote.d.ts.map

package/dist/lifecycleNote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleNote.d.ts","sourceRoot":"","sources":["../src/lifecycleNote.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,EAAE,EAAE,MAAM,CAAA;CACX;AAED,mCAAmC;AACnC,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,CAElE;AAED,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CASvD,CAAA"}

package/dist/lifecycleNote.js

@@ -0,0 +1,17 @@
+import { EventType } from '@ag-ui/client';
+/** Emit a lifecycle note event. */
+export function lifecycleNote(value) {
+    return { type: EventType.CUSTOM, name: 'lifecycle', value };
+}
+/** Human-readable label shown for each terminal outcome. */
+export const LIFECYCLE_NOTE_TEXT = {
+    running: '',
+    done: 'Done',
+    stopped: 'Stopped — cancelled',
+    rejected: 'Rejected',
+    error: 'Error',
+    superseded: 'Superseded by a re-run',
+    reset: 'Cleared from board',
+    dismissed: 'Error acknowledged — dismissed',
+};
+//# sourceMappingURL=lifecycleNote.js.map

package/dist/lifecycleNote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleNote.js","sourceRoot":"","sources":["../src/lifecycleNote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAWzC,mCAAmC;AACnC,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAA0B,CAAA;AACrF,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,MAAM,mBAAmB,GAA4B;IAC1D,OAAO,EAAE,EAAE;IACX,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,qBAAqB;IAC9B,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,UAAU,EAAE,wBAAwB;IACpC,KAAK,EAAE,oBAAoB;IAC3B,SAAS,EAAE,gCAAgC;CAC5C,CAAA"}

package/dist/messages.d.ts

@@ -0,0 +1,21 @@
+import type { Message, ToolCall } from '@ag-ui/client';
+export type AssistantMessage = Extract<Message, {
+    role: 'assistant';
+}>;
+export type ToolMessage = Extract<Message, {
+    role: 'tool';
+}>;
+export declare function isAssistant(m: Message): m is AssistantMessage;
+export declare function isToolMessage(m: Message): m is ToolMessage;
+export declare function toolCallsOf(m: Message): ToolCall[];
+/** True when an approval tool has been called but has no tool result yet. */
+export declare function hasPendingApproval(messages: readonly Message[], approvalNames: readonly string[]): boolean;
+/** Map each tool result message by the toolCallId it answers. */
+export declare function pairToolResults(messages: readonly Message[]): Map<string, ToolMessage>;
+/** Parsed arguments of the most recent approval tool call, or null. */
+export declare function lastApprovalArgs(messages: readonly Message[], approvalNames: readonly string[]): Record<string, unknown> | null;
+/** How many approval tool calls have a matching tool result. */
+export declare function resolvedApprovalCount(messages: readonly Message[], approvalNames: readonly string[]): number;
+/** True when at least one approval call has resolved. */
+export declare function approvalResolved(messages: readonly Message[], approvalNames: readonly string[]): boolean;
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAEtD,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,CAAA;AACtE,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAE5D,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,gBAAgB,CAE7D;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAE1D;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,QAAQ,EAAE,CAElD;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,OAAO,CAiBT;AAED,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAMtF;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAehC;AAED,gEAAgE;AAChE,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,MAAM,CAgBR;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,OAAO,CAET"}

package/dist/messages.js

@@ -0,0 +1,78 @@
+export function isAssistant(m) {
+    return m.role === 'assistant';
+}
+export function isToolMessage(m) {
+    return m.role === 'tool';
+}
+export function toolCallsOf(m) {
+    return isAssistant(m) && Array.isArray(m.toolCalls) ? m.toolCalls : [];
+}
+/** True when an approval tool has been called but has no tool result yet. */
+export function hasPendingApproval(messages, approvalNames) {
+    const resolvedIds = new Set();
+    for (const m of messages) {
+        if (isToolMessage(m) && typeof m.toolCallId === 'string')
+            resolvedIds.add(m.toolCallId);
+    }
+    for (const m of messages) {
+        for (const call of toolCallsOf(m)) {
+            if (approvalNames.includes(call.function.name) &&
+                typeof call.id === 'string' &&
+                !resolvedIds.has(call.id)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/** Map each tool result message by the toolCallId it answers. */
+export function pairToolResults(messages) {
+    const byCallId = new Map();
+    for (const m of messages) {
+        if (isToolMessage(m) && typeof m.toolCallId === 'string')
+            byCallId.set(m.toolCallId, m);
+    }
+    return byCallId;
+}
+/** Parsed arguments of the most recent approval tool call, or null. */
+export function lastApprovalArgs(messages, approvalNames) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const m = messages[i];
+        if (!m)
+            continue;
+        for (const call of toolCallsOf(m)) {
+            if (approvalNames.includes(call.function.name)) {
+                try {
+                    return JSON.parse(call.function.arguments);
+                }
+                catch {
+                    return null;
+                }
+            }
+        }
+    }
+    return null;
+}
+/** How many approval tool calls have a matching tool result. */
+export function resolvedApprovalCount(messages, approvalNames) {
+    const approvalCallIds = new Set();
+    for (const m of messages) {
+        for (const call of toolCallsOf(m)) {
+            if (approvalNames.includes(call.function.name) && typeof call.id === 'string') {
+                approvalCallIds.add(call.id);
+            }
+        }
+    }
+    const resolved = new Set();
+    for (const m of messages) {
+        if (isToolMessage(m) && typeof m.toolCallId === 'string' && approvalCallIds.has(m.toolCallId)) {
+            resolved.add(m.toolCallId);
+        }
+    }
+    return resolved.size;
+}
+/** True when at least one approval call has resolved. */
+export function approvalResolved(messages, approvalNames) {
+    return resolvedApprovalCount(messages, approvalNames) > 0;
+}
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

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

package/dist/prompt.d.ts

@@ -0,0 +1,3 @@
+/** Prepend the workflow-level prompt (if any) to an agent's own instructions. */
+export declare function composeInstructions(workflowPrompt: string | undefined, agentInstructions: string): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,iBAAiB,EAAE,MAAM,GACxB,MAAM,CAGR"}

package/dist/prompt.js

@@ -0,0 +1,6 @@
+/** Prepend the workflow-level prompt (if any) to an agent's own instructions. */
+export function composeInstructions(workflowPrompt, agentInstructions) {
+    const prefix = workflowPrompt?.trim();
+    return prefix ? `${prefix}\n\n${agentInstructions}` : agentInstructions;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,UAAU,mBAAmB,CACjC,cAAkC,EAClC,iBAAyB;IAEzB,MAAM,MAAM,GAAG,cAAc,EAAE,IAAI,EAAE,CAAA;IACrC,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,iBAAiB,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAA;AACzE,CAAC"}

package/dist/providers.d.ts

@@ -0,0 +1,4 @@
+import type { ProviderFactory, ProviderRegistry } from './types.js';
+/** Build a registry that resolves provider factories by name. */
+export declare function defineProviders(map: Record<string, ProviderFactory>): ProviderRegistry;
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAEnE,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,gBAAgB,CAQtF"}

package/dist/providers.js

@@ -0,0 +1,12 @@
+/** Build a registry that resolves provider factories by name. */
+export function defineProviders(map) {
+    return {
+        resolve(name) {
+            const factory = map[name];
+            if (!factory)
+                throw new Error(`Unknown provider: ${name}`);
+            return factory;
+        },
+    };
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAEA,iEAAiE;AACjE,MAAM,UAAU,eAAe,CAAC,GAAoC;IAClE,OAAO;QACL,OAAO,CAAC,IAAY;YAClB,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,CAAA;YACzB,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAA;YAC1D,OAAO,OAAO,CAAA;QAChB,CAAC;KACF,CAAA;AACH,CAAC"}