@zhin.js/workroom 0.0.0 → 0.0.2

package/lib/workroom-runtime/workroom-governed-dispatch-composition.d.ts

@@ -0,0 +1,32 @@
+import type { WorkroomDisclosureManifestAuthorityPort } from '../data-governance/disclosure-authority.js';
+export interface WorkroomGovernedDispatchGenerationBinding {
+    readonly generation: number;
+    readonly port: Pick<WorkroomDisclosureManifestAuthorityPort, 'revalidate'>;
+}
+export interface WorkroomGovernedOutboundComposition {
+    readonly projection: WorkroomDisclosureManifestAuthorityPort;
+    readonly remote: Pick<WorkroomDisclosureManifestAuthorityPort, 'revalidate'>;
+}
+/**
+ * Generation composition for the two outbound sinks. Projection needs trusted
+ * materialization; Remote gets revalidation only and cannot mint a Manifest.
+ */
+export declare function createGenerationOwnedWorkroomGovernedOutboundComposition(options: Readonly<{
+    generation: number;
+    signal: AbortSignal;
+    runtime: Readonly<{
+        generation: number;
+        disclosureManifest: WorkroomDisclosureManifestAuthorityPort;
+    }>;
+}>): WorkroomGovernedOutboundComposition;
+export interface GenerationOwnedWorkroomGovernedDispatchOptions {
+    generation: number;
+    signal: AbortSignal;
+    resolve(): WorkroomGovernedDispatchGenerationBinding | undefined;
+}
+export declare class GenerationOwnedWorkroomGovernedDispatchAuthority implements Pick<WorkroomDisclosureManifestAuthorityPort, 'revalidate'> {
+    #private;
+    constructor(options: Readonly<GenerationOwnedWorkroomGovernedDispatchOptions>);
+    revalidate(...args: Parameters<WorkroomDisclosureManifestAuthorityPort['revalidate']>): Promise<import("../data-governance.js").GovernedDisclosureRevalidationResult>;
+}
+//# sourceMappingURL=workroom-governed-dispatch-composition.d.ts.map

package/lib/workroom-runtime/workroom-governed-dispatch-composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workroom-governed-dispatch-composition.d.ts","sourceRoot":"","sources":["../../src/workroom-runtime/workroom-governed-dispatch-composition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uCAAuC,EACxC,MAAM,4CAA4C,CAAC;AAEpD,MAAM,WAAW,yCAAyC;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,uCAAuC,EAAE,YAAY,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,UAAU,EAAE,uCAAuC,CAAC;IAC7D,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,uCAAuC,EAAE,YAAY,CAAC,CAAC;CAC9E;AAED;;;GAGG;AACH,wBAAgB,wDAAwD,CAAC,OAAO,EAAE,QAAQ,CAAC;IACzF,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,QAAQ,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,kBAAkB,EAAE,uCAAuC,CAAC;KAC7D,CAAC,CAAC;CACJ,CAAC,GAAG,mCAAmC,CAevC;AAED,MAAM,WAAW,8CAA8C;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,IAAI,yCAAyC,GAAG,SAAS,CAAC;CAClE;AAED,qBAAa,gDACb,YAAW,IAAI,CAAC,uCAAuC,EAAE,YAAY,CAAC;;gBAGxD,OAAO,EAAE,QAAQ,CAAC,8CAA8C,CAAC;IAOvE,UAAU,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,uCAAuC,CAAC,YAAY,CAAC,CAAC;CAY5F"}

package/lib/workroom-runtime/workroom-governed-dispatch-composition.js

@@ -0,0 +1,43 @@
+/**
+ * Generation composition for the two outbound sinks. Projection needs trusted
+ * materialization; Remote gets revalidation only and cannot mint a Manifest.
+ */
+export function createGenerationOwnedWorkroomGovernedOutboundComposition(options) {
+    if (options.runtime.generation !== options.generation) {
+        throw new Error('Workroom governed outbound authority targets another Root generation');
+    }
+    return Object.freeze({
+        projection: options.runtime.disclosureManifest,
+        remote: new GenerationOwnedWorkroomGovernedDispatchAuthority({
+            generation: options.generation,
+            signal: options.signal,
+            resolve: () => Object.freeze({
+                generation: options.runtime.generation,
+                port: options.runtime.disclosureManifest,
+            }),
+        }),
+    });
+}
+export class GenerationOwnedWorkroomGovernedDispatchAuthority {
+    #options;
+    constructor(options) {
+        if (!Number.isSafeInteger(options.generation) || options.generation < 1) {
+            throw new Error('Workroom governed dispatch generation is invalid');
+        }
+        this.#options = options;
+    }
+    async revalidate(...args) {
+        const options = this.#options;
+        options.signal.throwIfAborted();
+        const current = options.resolve();
+        if (!current)
+            throw new Error('Workroom governed dispatch authority is unavailable');
+        if (current.generation !== options.generation) {
+            throw new Error('Workroom governed dispatch authority escaped its Root generation');
+        }
+        const operationSignal = args[1];
+        const signal = AbortSignal.any([options.signal, operationSignal]);
+        return await current.port.revalidate(args[0], signal);
+    }
+}
+//# sourceMappingURL=workroom-governed-dispatch-composition.js.map

package/lib/workroom-runtime/workroom-governed-dispatch-composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workroom-governed-dispatch-composition.js","sourceRoot":"","sources":["../../src/workroom-runtime/workroom-governed-dispatch-composition.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,MAAM,UAAU,wDAAwD,CAAC,OAOvE;IACA,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,kBAAkB;QAC9C,MAAM,EAAE,IAAI,gDAAgD,CAAC;YAC3D,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;gBAC3B,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU;gBACtC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,kBAAkB;aACzC,CAAC;SACH,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAQD,MAAM,OAAO,gDAAgD;IAElD,QAAQ,CAA2D;IAE5E,YAAY,OAAiE;QAC3E,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAG,IAAuE;QACzF,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACrF,IAAI,OAAO,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QACD,MAAM,eAAe,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;QAClE,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;CACF"}

package/lib/workroom-runtime/workroom-host-port.d.ts

@@ -0,0 +1,113 @@
+import type { WorkroomRuntimeHandle } from '../workroom/runtime.js';
+import type { WorkroomCatalog } from '../workroom/catalog.js';
+import type { PublishCapabilityPackCommand, PublishPlanningPolicyCommand, PublishProjectProfileCommand, PublishProjectProfileRollbackCommand, WorkroomProfileControlPort } from './workroom-profile-authority-runtime.js';
+import type { PortfolioSponsorCommandPort, PortfolioSponsorProjectionReadPort } from './workroom-portfolio-sponsor.js';
+import type { WorkroomEffectSponsorDecisionCommand, WorkroomEffectSponsorDecisionRecord } from './workroom-acceptance-production-composition.js';
+import type { ProjectKnowledgeEntry, ProjectKnowledgeSnapshot } from '../workroom/project-knowledge-registry.js';
+import type { WorkroomDataLifecycleConsoleControlPort } from './workroom-data-lifecycle-console.js';
+import type { WorkroomRunControlCommand, WorkroomRunControlReceipt } from '../workroom/workroom-run-control.js';
+/**
+ * Workroom Host boundary, published beside `agentHostToken` by the same Root
+ * generation. The Agent core never references these types.
+ */
+export interface WorkroomHostPort {
+    readonly console: WorkroomHostConsolePort;
+}
+export interface WorkroomHostConsolePort {
+    readonly workroom: WorkroomRuntimeHandle;
+    /** Sponsor-authorized Run mutation plane; identity is injected from the Host token. */
+    readonly workroomControl?: AgentHostWorkroomRunControlPort;
+    /** Persistent topology SSOT; edits take effect without rebuilding the generation. */
+    readonly workroomCatalog: WorkroomCatalog;
+    /** Authenticated Host-only mutations; identity is injected by the Root and absent from caller DTOs. */
+    readonly workroomProfiles?: AgentHostWorkroomProfileControlPort;
+    /** Content-free Knowledge registry; identity and Sponsor authority are Host-injected. */
+    readonly workroomKnowledge?: AgentHostWorkroomKnowledgeControlPort;
+    /** Content-free Sponsor projection and typed commands; HTTP injects the authenticated principal. */
+    readonly portfolioSponsor?: AgentHostPortfolioSponsorControlPort;
+    /** Root-private Effect approval plane; HTTP injects identity and discussion has no ingress. */
+    readonly effectSponsor?: AgentHostEffectSponsorControlPort;
+    /** Root-role + current P12 authorized, content-free Payload Lifecycle plane. */
+    readonly dataLifecycle?: WorkroomDataLifecycleConsoleControlPort;
+}
+export interface AgentHostWorkroomRunControlPort {
+    execute(command: WorkroomRunControlCommand, authenticatedPrincipal: Readonly<{
+        principalId: string;
+    }>): Promise<WorkroomRunControlReceipt>;
+}
+export interface AgentHostPortfolioSponsorControlPort extends Pick<PortfolioSponsorCommandPort, 'execute'>, PortfolioSponsorProjectionReadPort {
+}
+export interface AgentHostEffectSponsorControlPort {
+    decide(command: Omit<WorkroomEffectSponsorDecisionCommand, 'principalId'>, authenticatedPrincipal: Readonly<{
+        principalId: string;
+    }>): Promise<WorkroomEffectSponsorDecisionRecord>;
+}
+export interface AgentHostWorkroomProfileControlPort {
+    getPlanningStatus(projectId: string, authenticatedPrincipal?: Readonly<{
+        principalId: string;
+    }>): Promise<WorkroomPlanningSetupStatus>;
+    bootstrapPlanning(command: WorkroomPlanningBootstrapCommand, authenticatedPrincipal: Readonly<{
+        principalId: string;
+    }>): Promise<WorkroomPlanningSetupStatus>;
+    publishPack(command: Omit<PublishCapabilityPackCommand, 'version' | 'authenticatedPrincipalId'>, authenticatedPrincipal: Readonly<{
+        principalId: string;
+    }>): ReturnType<WorkroomProfileControlPort['publishPack']>;
+    publishProfile(command: Omit<PublishProjectProfileCommand, 'version' | 'authenticatedPrincipalId' | 'source'>, authenticatedPrincipal: Readonly<{
+        principalId: string;
+    }>): ReturnType<WorkroomProfileControlPort['publishProfile']>;
+    publishRollback(command: Omit<PublishProjectProfileRollbackCommand, 'version' | 'authenticatedPrincipalId' | 'source'>, authenticatedPrincipal: Readonly<{
+        principalId: string;
+    }>): ReturnType<WorkroomProfileControlPort['publishRollback']>;
+    publishPlanningPolicy(command: Omit<PublishPlanningPolicyCommand, 'version' | 'authenticatedPrincipalId' | 'catalogRevision' | 'projectDigest' | 'profileDigest'>, authenticatedPrincipal: Readonly<{
+        principalId: string;
+    }>): ReturnType<WorkroomProfileControlPort['publishPlanningPolicy']>;
+}
+export interface WorkroomPlanningBootstrapCommand {
+    readonly operationId: string;
+    readonly projectId: string;
+    readonly expectedRegistryRevision: number;
+    readonly includeTools?: readonly string[];
+    readonly includeSkills?: readonly string[];
+}
+export interface WorkroomPlanningSetupStatus {
+    readonly projectId: string;
+    readonly ready: boolean;
+    readonly principalId?: string;
+    readonly trustedPackPublisher: boolean;
+    readonly projectSponsor: boolean;
+    readonly catalogReady: boolean;
+    readonly registryRevision: number;
+    readonly activeProfile?: Readonly<{
+        revisionId: string;
+        digest: string;
+    }>;
+    readonly planningPolicyReady: boolean;
+    readonly disclosureReady: boolean;
+    readonly disclosureConfigReady: boolean;
+    readonly modelProviderAlias?: string;
+    readonly availableAgents: readonly string[];
+    readonly availableTools: readonly string[];
+    readonly availableSkills: readonly string[];
+    readonly diagnostics: readonly string[];
+}
+export interface AgentHostWorkroomKnowledgeControlPort {
+    read(projectId: string): Promise<ProjectKnowledgeSnapshot>;
+    publish(command: Readonly<{
+        operationId: string;
+        projectId: string;
+        expectedRevision: number;
+        entries: readonly ProjectKnowledgeEntry[];
+    }>, authenticatedPrincipal: Readonly<{
+        principalId: string;
+    }>): Promise<ProjectKnowledgeSnapshot>;
+    rollback(command: Readonly<{
+        operationId: string;
+        projectId: string;
+        expectedRevision: number;
+        restoreRevision: number;
+    }>, authenticatedPrincipal: Readonly<{
+        principalId: string;
+    }>): Promise<ProjectKnowledgeSnapshot>;
+}
+export declare const workroomHostToken: import("@zhin.js/plugin-runtime").Token<WorkroomHostPort>;
+//# sourceMappingURL=workroom-host-port.d.ts.map

package/lib/workroom-runtime/workroom-host-port.d.ts.map

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

package/lib/workroom-runtime/workroom-host-port.js

@@ -0,0 +1,3 @@
+import { createToken } from '@zhin.js/plugin-runtime';
+export const workroomHostToken = createToken('zhin.host.workroom', 'Workroom console and control projections owned by the Root generation');
+//# sourceMappingURL=workroom-host-port.js.map

package/lib/workroom-runtime/workroom-host-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workroom-host-port.js","sourceRoot":"","sources":["../../src/workroom-runtime/workroom-host-port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAyItD,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAC1C,oBAAoB,EACpB,uEAAuE,CACxE,CAAC"}

package/lib/workroom-runtime/workroom-journal-payload-composition.d.ts

@@ -0,0 +1,16 @@
+import { type WorkroomJournalPayloadPort } from '../workroom/journal/index.js';
+export interface GenerationOwnedWorkroomJournalPayloadPort {
+    readonly generation: number;
+    readonly payloads: WorkroomJournalPayloadPort;
+    activate(authority: WorkroomJournalPayloadPort): void;
+}
+/**
+ * Root-only latch used to construct the durable Journal before the generation's
+ * private data-governance runtime is ready. It never exposes that runtime,
+ * repository or Vault and has no plaintext fallback.
+ */
+export declare function createGenerationOwnedWorkroomJournalPayloadPort(options: Readonly<{
+    generation: number;
+    signal: AbortSignal;
+}>): GenerationOwnedWorkroomJournalPayloadPort;
+//# sourceMappingURL=workroom-journal-payload-composition.d.ts.map

package/lib/workroom-runtime/workroom-journal-payload-composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workroom-journal-payload-composition.d.ts","sourceRoot":"","sources":["../../src/workroom-runtime/workroom-journal-payload-composition.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,8BAA8B,CAAC;AAEtC,MAAM,WAAW,yCAAyC;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,0BAA0B,GAAG,IAAI,CAAC;CACvD;AAED;;;;GAIG;AACH,wBAAgB,+CAA+C,CAC7D,OAAO,EAAE,QAAQ,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC,GAC7D,yCAAyC,CAuD3C"}

package/lib/workroom-runtime/workroom-journal-payload-composition.js

@@ -0,0 +1,69 @@
+import { WorkroomJournalPayloadAuthorityUnavailableError, } from '../workroom/journal/index.js';
+/**
+ * Root-only latch used to construct the durable Journal before the generation's
+ * private data-governance runtime is ready. It never exposes that runtime,
+ * repository or Vault and has no plaintext fallback.
+ */
+export function createGenerationOwnedWorkroomJournalPayloadPort(options) {
+    if (!Number.isSafeInteger(options.generation) || options.generation <= 0) {
+        throw new Error('Workroom Journal payload generation must be a positive integer');
+    }
+    let delegate;
+    const requireAuthority = () => {
+        options.signal.throwIfAborted();
+        if (!delegate)
+            throw new WorkroomJournalPayloadAuthorityUnavailableError();
+        return delegate;
+    };
+    const payloads = Object.freeze({
+        write: async (input) => {
+            const result = await requireAuthority().write(input);
+            options.signal.throwIfAborted();
+            return result;
+        },
+        read: async (input) => {
+            const result = await requireAuthority().read(input);
+            options.signal.throwIfAborted();
+            return result;
+        },
+        publish: async (input) => {
+            const authority = requireAuthority();
+            if (!authority.publish)
+                throw new WorkroomJournalPayloadAuthorityUnavailableError();
+            await authority.publish(input);
+            options.signal.throwIfAborted();
+        },
+        prepare: async (input) => {
+            const authority = requireAuthority();
+            if (!authority.prepare)
+                throw new WorkroomJournalPayloadAuthorityUnavailableError();
+            await authority.prepare(input);
+            options.signal.throwIfAborted();
+        },
+        abandon: async (input) => {
+            const authority = requireAuthority();
+            if (!authority.abandon)
+                throw new WorkroomJournalPayloadAuthorityUnavailableError();
+            await authority.abandon(input);
+            options.signal.throwIfAborted();
+        },
+        reconcile: async (input) => {
+            const authority = requireAuthority();
+            if (!authority.reconcile)
+                throw new WorkroomJournalPayloadAuthorityUnavailableError();
+            await authority.reconcile(input);
+            options.signal.throwIfAborted();
+        },
+    });
+    return Object.freeze({
+        generation: options.generation,
+        payloads,
+        activate(authority) {
+            options.signal.throwIfAborted();
+            if (delegate)
+                throw new Error('Workroom Journal payload authority is already active');
+            delegate = authority;
+        },
+    });
+}
+//# sourceMappingURL=workroom-journal-payload-composition.js.map

package/lib/workroom-runtime/workroom-journal-payload-composition.js.map

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

package/lib/workroom-runtime/workroom-local-agent-core-adapter.d.ts

@@ -0,0 +1,16 @@
+import type { ResolvedAgentBinding } from '@zhin.js/agent/config';
+import { type AgentCore, type ZhinAgentPrivate } from '@zhin.js/agent/core';
+import type { TurnEvent } from '@zhin.js/agent/event';
+import type { PluginAILoopHookRegistry } from '@zhin.js/agent';
+import type { WorkroomLocalAgentTurnPort, WorkroomLocalTurnJournalAttribution } from './workroom-local-agent-loop.js';
+export interface AgentCoreWorkroomLocalTurnPortOptions {
+    readonly host: ZhinAgentPrivate;
+    readonly core: AgentCore;
+    readonly resolveBinding: (agentDefinitionId: string | undefined) => ResolvedAgentBinding | undefined;
+    readonly generation: number;
+    readonly loopHooks?: PluginAILoopHookRegistry;
+    readonly onTurnEvent?: (attribution: WorkroomLocalTurnJournalAttribution, event: TurnEvent) => void | Promise<void>;
+}
+/** Exact Deferred Capability Plan adapter over the production AgentCore/agentLoop. */
+export declare function createAgentCoreWorkroomLocalTurnPort(options: AgentCoreWorkroomLocalTurnPortOptions): WorkroomLocalAgentTurnPort;
+//# sourceMappingURL=workroom-local-agent-core-adapter.d.ts.map

package/lib/workroom-runtime/workroom-local-agent-core-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workroom-local-agent-core-adapter.d.ts","sourceRoot":"","sources":["../../src/workroom-runtime/workroom-local-agent-core-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAA2B,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACrG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAG/D,OAAO,KAAK,EAEV,0BAA0B,EAC1B,mCAAmC,EACpC,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,KAAK,oBAAoB,GAAG,SAAS,CAAC;IACrG,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,wBAAwB,CAAC;IAC9C,QAAQ,CAAC,WAAW,CAAC,EAAE,CACrB,WAAW,EAAE,mCAAmC,EAChD,KAAK,EAAE,SAAS,KACb,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,sFAAsF;AACtF,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,qCAAqC,GAC7C,0BAA0B,CAK5B"}

package/lib/workroom-runtime/workroom-local-agent-core-adapter.js

@@ -0,0 +1,100 @@
+import { createUserMessage } from '@zhin.js/ai';
+import { collectAgentLoopTurnRun } from '@zhin.js/agent/core';
+import { TurnToolRuntime, TurnToolExecutionAuthority } from '@zhin.js/agent/tool';
+import { createTurnIngress, runWithAgentTurnConfiguration } from '@zhin.js/agent/turn';
+/** Exact Deferred Capability Plan adapter over the production AgentCore/agentLoop. */
+export function createAgentCoreWorkroomLocalTurnPort(options) {
+    return Object.freeze({
+        run: async (input, signal) => await runAgentCoreLocalTurn(options, input, signal),
+    });
+}
+async function runAgentCoreLocalTurn(options, input, signal) {
+    const binding = options.resolveBinding(input.agentDefinitionId);
+    if (!binding) {
+        throw new Error(`Local Assignment Agent binding is unavailable: ${input.agentDefinitionId ?? 'unbound'}`);
+    }
+    const publish = async (event) => {
+        await options.onTurnEvent?.(input.journalAttribution, event);
+    };
+    const plan = input.capabilityPlan;
+    const turn = createTurnIngress({
+        identity: Object.freeze({
+            rootId: 'workroom-local-assignment',
+            generation: options.generation,
+            traceId: input.turnId,
+            turnId: input.turnId,
+        }),
+        origin: Object.freeze({ kind: 'http', sessionId: input.sessionId }),
+        principal: Object.freeze({
+            subjectId: input.principalId,
+            roles: Object.freeze(['workroom_assignment']),
+        }),
+        intent: Object.freeze({ kind: 'new' }),
+        input: Object.freeze({
+            text: input.prompt,
+            metadata: Object.freeze({ ...input.journalAttribution }),
+        }),
+        session: Object.freeze({ key: input.sessionId }),
+        policy: Object.freeze({
+            permissions: Object.freeze([]),
+            unattended: true,
+            shell: Object.freeze({
+                security: 'allowlist',
+                execPreset: 'development',
+                approvalMode: 'auto',
+                isolation: 'required',
+            }),
+            filesystem: Object.freeze({
+                workspaceRoot: input.workspaceRoot,
+                workingDirectory: input.workspaceRoot,
+                access: 'workspace-write',
+            }),
+        }),
+        capabilities: Object.freeze({
+            tools: Object.freeze(plan.capabilities.map(capability => capability.name)),
+            skills: Object.freeze([]),
+        }),
+        signal,
+        ports: Object.freeze({ journal: Object.freeze({ append: publish }) }),
+    });
+    const runtime = new TurnToolRuntime(turn, plan.capabilities);
+    const activeSkillsContext = plan.controller.loadedSkillInstructions().join('\n\n');
+    const run = () => collectAgentLoopTurnRun(options.core.runText({
+        host: options.host,
+        sessionId: input.sessionId,
+        rawContent: input.prompt,
+        promptProfile: { kind: 'interactive' },
+        turnContext: turn,
+        allTools: [...plan.allTools],
+        resolvedTools: [...plan.resolvedTools],
+        toolExecution: new TurnToolExecutionAuthority(runtime),
+        toolEventSource: 'authority',
+        loopHooks: options.loopHooks,
+        promptRuntime: {
+            activeSkillsContext,
+            agentNickname: binding.nickname,
+            modelId: binding.model,
+            providerAlias: binding.providerAlias,
+        },
+        personaEnhanced: [
+            'You are executing one exact Workroom Assignment.',
+            'Use only the supplied Deferred Capability Plan and workspace authority.',
+            'Return the requested structured Task Report JSON; never mutate Workroom Task status.',
+            activeSkillsContext,
+        ].filter(Boolean).join('\n\n'),
+        modelId: binding.model,
+        modelCandidates: [binding.model],
+        initialMessages: [createUserMessage(input.prompt)],
+        signal,
+        deferredStats: plan.deferredStats,
+        deferredController: plan.controller,
+        toolCatalog: plan.catalog,
+        toolLoading: 'deferred',
+        conversationPersistence: 'none',
+        generation: options.generation,
+        onTurnEvent: event => { void publish(event); },
+    }));
+    const result = await runWithAgentTurnConfiguration({ activeBinding: binding }, run);
+    return Object.freeze({ output: result.reply });
+}
+//# sourceMappingURL=workroom-local-agent-core-adapter.js.map

package/lib/workroom-runtime/workroom-local-agent-core-adapter.js.map

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

package/lib/workroom-runtime/workroom-local-agent-loop.d.ts

@@ -0,0 +1,91 @@
+import type { DeferredCapabilityPlan } from '@zhin.js/agent/runtime';
+import type { LocalModelExecutionPort, LocalModelExecutionRequest } from './workroom-local-assignment-executor.js';
+import { type WorkroomGovernedPayloadPublicationPort, type WorkroomGovernedPayloadReceipt, type WorkroomTaskReportPayloadPort, type WorkroomTaskReportStore } from '../workroom/workroom-task-report-store.js';
+export interface WorkroomLocalTurnJournalAttribution {
+    readonly projectId: string;
+    readonly runId: string;
+    readonly taskKey: string;
+    readonly taskRevision: number;
+    readonly assignmentId: string;
+    readonly attempt: number;
+    readonly fence: number;
+}
+export interface WorkroomLocalAgentTurnInput {
+    readonly sessionId: string;
+    readonly turnId: string;
+    readonly principalId: string;
+    readonly agentDefinitionId?: string;
+    readonly workspaceRoot: string;
+    readonly journalAttribution: WorkroomLocalTurnJournalAttribution;
+    readonly prompt: string;
+    readonly capabilityPlan: DeferredCapabilityPlan;
+}
+export interface WorkroomLocalAgentTurnResult {
+    readonly output: string;
+}
+export interface WorkroomEvidencePayloadWriteInput {
+    readonly mediaType: string;
+    readonly content: string;
+    /** Untrusted model assertion. The writer must resolve/verify a canonical source independently. */
+    readonly claimedSource: WorkroomEvidenceClaimedSource;
+    readonly attribution: WorkroomLocalTurnJournalAttribution;
+    readonly publication: WorkroomGovernedPayloadPublicationPort;
+}
+/** Content-free receipt returned by the governed Payload Vault boundary. */
+export interface WorkroomEvidencePayloadReceipt extends WorkroomGovernedPayloadReceipt {
+}
+export interface WorkroomEvidenceClaimedSource {
+    readonly kind: 'command' | 'file' | 'url' | 'tool' | 'human';
+    readonly locator: string;
+}
+/** Stable narrow port; P12 storage implementations adapt to this boundary. */
+export interface WorkroomEvidencePayloadWriterPort {
+    write(input: WorkroomEvidencePayloadWriteInput, signal: AbortSignal): Promise<WorkroomEvidencePayloadReceipt>;
+}
+export declare const workroomEvidencePayloadWriterToken: import("@zhin.js/plugin-runtime").Token<WorkroomEvidencePayloadWriterPort>;
+export declare const workroomTaskReportPayloadToken: import("@zhin.js/plugin-runtime").Token<WorkroomTaskReportPayloadPort>;
+/** Narrow production seam adapted to ZhinAgent's AgentCore/agentLoop. */
+export interface WorkroomLocalAgentTurnPort {
+    run(input: WorkroomLocalAgentTurnInput, signal: AbortSignal): Promise<WorkroomLocalAgentTurnResult>;
+}
+export interface DurableReportLocalModelExecutionPortOptions {
+    readonly turn: WorkroomLocalAgentTurnPort;
+    readonly reports: WorkroomTaskReportStore;
+    readonly payloads: WorkroomEvidencePayloadWriterPort;
+    readonly readPrompt?: (request: LocalModelExecutionRequest) => string | Promise<string>;
+}
+/** Persists content-addressed evidence/report before completion can escape. */
+export declare class DurableReportLocalModelExecutionPort implements LocalModelExecutionPort {
+    #private;
+    readonly options: DurableReportLocalModelExecutionPortOptions;
+    constructor(options: DurableReportLocalModelExecutionPortOptions);
+    execute(request: LocalModelExecutionRequest, signal: AbortSignal): AsyncGenerator<Readonly<{
+        version: 1;
+        type: "heartbeat";
+        eventId: "turn-admitted";
+    }> | Readonly<{
+        version: 1;
+        type: "progress";
+        eventId: "model-turn-completed";
+        progress: Readonly<{
+            summary: "Local Agent loop produced a structured Task Report";
+        }>;
+    }> | Readonly<{
+        version: 1;
+        type: "execution_completed";
+        eventId: "durable-report-published";
+        completion: Readonly<{
+            report: Readonly<{
+                ref: string;
+                digest: string;
+            }>;
+            candidate: Readonly<{
+                ref: `workroom-candidate:${string}`;
+                hash: string;
+            }>;
+            completionReceiptDigest: string;
+        }>;
+    }>, void, unknown>;
+}
+export declare function structuredTaskReportPrompt(): readonly string[];
+//# sourceMappingURL=workroom-local-agent-loop.d.ts.map

package/lib/workroom-runtime/workroom-local-agent-loop.d.ts.map

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