@plurnk/plurnk-a2a 1.9.0

package/dist/PlurnkTaskStore.js

@@ -0,0 +1,271 @@
+var _a;
+import { Role, TaskState, } from "@a2a-js/sdk";
+import {} from "@a2a-js/sdk/server";
+import { RequestMalformedError } from "@a2a-js/sdk/errors";
+const nonempty = (value) => typeof value === "string" && value.length > 0;
+const message = (messageId, contextId, taskId, role, content, mediaType = "text/plain") => ({
+    messageId,
+    contextId,
+    taskId,
+    role,
+    parts: [{
+            content: { $case: "text", value: content },
+            filename: "",
+            mediaType,
+            metadata: {},
+        }],
+    metadata: {},
+    extensions: [],
+    referenceTaskIds: [],
+});
+const messageIdFromSource = (source, fallback) => {
+    if (!nonempty(source))
+        return fallback;
+    try {
+        const segments = new URL(source).pathname.split("/").filter(Boolean);
+        const marker = segments.lastIndexOf("messages");
+        return marker >= 0 && nonempty(segments[marker + 1])
+            ? decodeURIComponent(segments[marker + 1])
+            : fallback;
+    }
+    catch {
+        return fallback;
+    }
+};
+const terminalArtifact = (result) => {
+    if (result === null || result.status < 200 || result.status >= 400)
+        return [];
+    if (!nonempty(result.content))
+        return [];
+    return [{
+            artifactId: "result",
+            name: "Result",
+            description: "The terminal Plurnk SEND deliverable.",
+            parts: [{
+                    content: { $case: "text", value: result.content },
+                    filename: "",
+                    mediaType: nonempty(result.mimetype) ? result.mimetype : "text/markdown",
+                    metadata: {},
+                }],
+            metadata: {},
+            extensions: [],
+        }];
+};
+class PlurnkTaskStore {
+    #port;
+    #workspace;
+    constructor(port, workspace) {
+        this.#port = port;
+        this.#workspace = workspace;
+    }
+    async binding(taskId) {
+        const workspaceId = await this.#workspace.id();
+        const task = await this.#port.readWorker({
+            workspaceId,
+            identity: { name: taskId },
+        });
+        if (task === null || task.origin !== "model" || task.parentWorkerId === null)
+            return null;
+        const context = await this.#port.readWorker({
+            workspaceId,
+            identity: { id: task.parentWorkerId },
+        });
+        if (context === null || context.origin !== "model" || context.parentWorkerId !== null) {
+            throw new Error(`A2A Task '${taskId}' has no unique root Context worker.`);
+        }
+        const loops = await this.#port.listWorkerLoops({
+            workspaceId,
+            workerId: task.id,
+        });
+        const loop = loops
+            .filter(({ promptSource }) => _a.#ownsSource(promptSource, context.name, task.name))
+            .at(-1) ?? null;
+        if (loop === null)
+            return null;
+        return { context, task, loop };
+    }
+    async ownsContext(context) {
+        if (context.origin !== "model" || context.parentWorkerId !== null)
+            return false;
+        const children = await this.#port.listWorkers(await this.#workspace.id(), {
+            origin: "model",
+            parentWorkerId: context.id,
+        });
+        for (const child of children) {
+            if (await this.binding(child.name) !== null)
+                return true;
+        }
+        return false;
+    }
+    async load(taskId, context) {
+        this.#assertTenant(context);
+        const binding = await this.binding(taskId);
+        return binding === null ? undefined : await this.#project(binding);
+    }
+    async save(task, context) {
+        this.#assertTenant(context);
+        const binding = await this.binding(task.id);
+        if (binding === null) {
+            // The SDK turns an executor-side admission rejection into an
+            // ephemeral FAILED Task event. It is protocol evidence, not
+            // authority to create a second Task store or adopt a Worker.
+            if (task.status?.state === TaskState.TASK_STATE_FAILED)
+                return;
+            throw new Error(`A2A Task '${task.id}' has no Plurnk worker.`);
+        }
+        if (binding.context.name !== task.contextId) {
+            throw new Error(`A2A Task '${task.id}' belongs to Context '${binding.context.name}', not '${task.contextId}'.`);
+        }
+        // Core state is authoritative. SDK merge writes validate identity but
+        // never create a parallel Task lifecycle in this projection store.
+        if (task.status?.state === TaskState.TASK_STATE_CANCELED) {
+            await this.#port.cancelWorker({
+                workspaceId: await this.#workspace.id(),
+                workerId: binding.task.id,
+                reason: "A2A caller cancelled the Task",
+            });
+        }
+    }
+    async list(params, context) {
+        this.#assertTenant(context);
+        const workspaceId = await this.#workspace.id();
+        const pageSize = params.pageSize ?? 50;
+        const offset = params.pageToken.length === 0 ? 0 : Number(params.pageToken);
+        if (!Number.isSafeInteger(offset) || offset < 0) {
+            throw new RequestMalformedError("pageToken must be an empty string or a non-negative integer offset.");
+        }
+        let taskWorkers;
+        if (params.contextId.length > 0) {
+            const contextWorker = await this.#port.readWorker({
+                workspaceId,
+                identity: { name: params.contextId },
+            });
+            if (contextWorker === null
+                || contextWorker.origin !== "model"
+                || contextWorker.parentWorkerId !== null) {
+                taskWorkers = [];
+            }
+            else {
+                taskWorkers = await this.#port.listWorkers(workspaceId, {
+                    origin: "model",
+                    parentWorkerId: contextWorker.id,
+                });
+            }
+        }
+        else {
+            taskWorkers = (await this.#port.listWorkers(workspaceId, { origin: "model" }))
+                .filter(({ parentWorkerId }) => parentWorkerId !== null);
+        }
+        const projected = (await Promise.all(taskWorkers.map(({ name }) => this.load(name, context))))
+            .filter((task) => task !== undefined)
+            .filter((task) => params.status === TaskState.TASK_STATE_UNSPECIFIED
+            || task.status?.state === params.status)
+            .filter((task) => params.statusTimestampAfter === undefined
+            || (task.status?.timestamp !== undefined
+                && Date.parse(task.status.timestamp) >= Date.parse(params.statusTimestampAfter)))
+            .map((task) => params.includeArtifacts === true ? task : { ...task, artifacts: [] });
+        const tasks = projected.slice(offset, offset + pageSize);
+        const next = offset + tasks.length;
+        return {
+            tasks,
+            nextPageToken: next < projected.length ? String(next) : "",
+            pageSize,
+            totalSize: projected.length,
+        };
+    }
+    async #project(binding) {
+        const { context, task, loop } = binding;
+        if (loop === null) {
+            return {
+                id: task.name,
+                contextId: context.name,
+                status: {
+                    state: TaskState.TASK_STATE_SUBMITTED,
+                    message: undefined,
+                    timestamp: undefined,
+                },
+                artifacts: [],
+                history: [],
+                metadata: {},
+            };
+        }
+        const workspaceId = await this.#workspace.id();
+        const [rows, interactions] = await Promise.all([
+            this.#port.readLog({
+                workspaceId,
+                workerId: task.id,
+                loopId: loop.id,
+                limit: 1000,
+            }),
+            this.#port.pendingClientInteractions(workspaceId),
+        ]);
+        const pending = interactions.find((candidate) => candidate.workerId === task.id && candidate.loopId === loop.id) ?? null;
+        const state = _a.#state(loop.status, pending);
+        const statusMessage = _a.#statusMessage(context.name, task.name, loop.terminalResult, pending);
+        const history = rows
+            .filter((row) => row.loop_id === loop.id && row.op === "prompt" && nonempty(row.rx))
+            .toSorted((left, right) => Number(left.id) - Number(right.id))
+            .map((row) => message(messageIdFromSource(row.source, `plurnk-log-${String(row.id)}`), context.name, task.name, Role.ROLE_USER, row.rx, nonempty(row.mimetype_rx) ? row.mimetype_rx : "text/markdown"));
+        return {
+            id: task.name,
+            contextId: context.name,
+            status: {
+                state,
+                message: statusMessage,
+                timestamp: loop.terminatedAt ?? undefined,
+            },
+            artifacts: terminalArtifact(loop.terminalResult),
+            history,
+            metadata: {},
+        };
+    }
+    #assertTenant(context) {
+        if ((context.tenant ?? "") !== "") {
+            throw new RequestMalformedError("This A2A exposure does not define tenant routing.");
+        }
+    }
+    static #state(status, pending) {
+        if (pending !== null)
+            return TaskState.TASK_STATE_INPUT_REQUIRED;
+        if (status === 100)
+            return TaskState.TASK_STATE_SUBMITTED;
+        if (status === 102 || status === 202)
+            return TaskState.TASK_STATE_WORKING;
+        if (status === 200)
+            return TaskState.TASK_STATE_COMPLETED;
+        if (status === 499)
+            return TaskState.TASK_STATE_CANCELED;
+        return TaskState.TASK_STATE_FAILED;
+    }
+    static #statusMessage(contextId, taskId, result, pending) {
+        if (pending !== null) {
+            return message(`plurnk-interaction-${pending.interactionId}`, contextId, taskId, Role.ROLE_AGENT, pending.request.message ?? `${pending.request.toolName} requires input.`);
+        }
+        const detail = result?.problem?.detail;
+        return nonempty(detail)
+            ? message(`plurnk-terminal-${taskId}`, contextId, taskId, Role.ROLE_AGENT, detail)
+            : undefined;
+    }
+    static #ownsSource(source, contextId, taskId) {
+        if (source === null)
+            return false;
+        try {
+            const url = new URL(source);
+            const segments = url.pathname.split("/").filter(Boolean).map(decodeURIComponent);
+            return url.protocol === "a2a:"
+                && segments.length === 6
+                && segments[0] === "contexts"
+                && segments[1] === contextId
+                && segments[2] === "tasks"
+                && segments[3] === taskId
+                && segments[4] === "messages"
+                && segments[5].length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+_a = PlurnkTaskStore;
+export default PlurnkTaskStore;
+//# sourceMappingURL=PlurnkTaskStore.js.map

package/dist/PlurnkTaskStore.js.map

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

package/dist/WorkspaceBinding.d.ts

@@ -0,0 +1,13 @@
+import type { ApplicationPort } from "@plurnk/plurnk-contracts";
+export interface A2aWorkspaceConfiguration {
+    readonly name: string;
+    /** Required only when creating a new workspace; null adopts an existing named workspace. */
+    readonly projectRoot: string | null;
+}
+/** Lazily resolves the workspace owned by one inbound A2A exposure. */
+export default class WorkspaceBinding {
+    #private;
+    constructor(port: ApplicationPort, configuration: A2aWorkspaceConfiguration);
+    id(): Promise<number>;
+}
+//# sourceMappingURL=WorkspaceBinding.d.ts.map

package/dist/WorkspaceBinding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceBinding.d.ts","sourceRoot":"","sources":["../src/WorkspaceBinding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,WAAW,yBAAyB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4FAA4F;IAC5F,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,uEAAuE;AACvE,MAAM,CAAC,OAAO,OAAO,gBAAgB;;IAKjC,YAAY,IAAI,EAAE,eAAe,EAAE,aAAa,EAAE,yBAAyB,EAG1E;IAED,EAAE,IAAI,OAAO,CAAC,MAAM,CAAC,CAMpB;CA4BJ"}

package/dist/WorkspaceBinding.js

@@ -0,0 +1,40 @@
+/** Lazily resolves the workspace owned by one inbound A2A exposure. */
+export default class WorkspaceBinding {
+    #port;
+    #configuration;
+    #resolution = null;
+    constructor(port, configuration) {
+        this.#port = port;
+        this.#configuration = structuredClone(configuration);
+    }
+    id() {
+        this.#resolution ??= this.#resolve().catch((cause) => {
+            this.#resolution = null;
+            throw cause;
+        });
+        return this.#resolution;
+    }
+    async #resolve() {
+        const matches = (await this.#port.listWorkspaces())
+            .filter(({ name }) => name === this.#configuration.name);
+        if (matches.length > 1) {
+            throw new Error(`A2A workspace name '${this.#configuration.name}' is not unique.`);
+        }
+        const existing = matches[0];
+        if (existing !== undefined) {
+            if (this.#configuration.projectRoot !== null
+                && existing.project_root !== this.#configuration.projectRoot) {
+                throw new Error(`A2A workspace '${this.#configuration.name}' has project root `
+                    + `${JSON.stringify(existing.project_root)}, not configured root `
+                    + `${JSON.stringify(this.#configuration.projectRoot)}.`);
+            }
+            return existing.id;
+        }
+        const created = await this.#port.createWorkspace({
+            name: this.#configuration.name,
+            projectRoot: this.#configuration.projectRoot,
+        });
+        return created.workspaceId;
+    }
+}
+//# sourceMappingURL=WorkspaceBinding.js.map

package/dist/WorkspaceBinding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceBinding.js","sourceRoot":"","sources":["../src/WorkspaceBinding.ts"],"names":[],"mappings":"AAQA,uEAAuE;AACvE,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACxB,KAAK,CAAkB;IACvB,cAAc,CAA4B;IACnD,WAAW,GAA2B,IAAI,CAAC;IAE3C,YAAY,IAAqB,EAAE,aAAwC;QACvE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,cAAc,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;IACzD,CAAC;IAED,EAAE;QACE,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACjD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,MAAM,KAAK,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,QAAQ;QACV,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;aAC9C,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,cAAc,CAAC,IAAI,kBAAkB,CAAC,CAAC;QACvF,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzB,IACI,IAAI,CAAC,cAAc,CAAC,WAAW,KAAK,IAAI;mBACrC,QAAQ,CAAC,YAAY,KAAK,IAAI,CAAC,cAAc,CAAC,WAAW,EAC9D,CAAC;gBACC,MAAM,IAAI,KAAK,CACX,kBAAkB,IAAI,CAAC,cAAc,CAAC,IAAI,qBAAqB;sBAC7D,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,wBAAwB;sBAChE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,GAAG,CAC1D,CAAC;YACN,CAAC;YACD,OAAO,QAAQ,CAAC,EAAE,CAAC;QACvB,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;YAC7C,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI;YAC9B,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,WAAW;SAC/C,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,WAAW,CAAC;IAC/B,CAAC;CACJ"}

package/dist/config.d.ts

@@ -0,0 +1,22 @@
+import type { A2AAgentDefinition as A2aAgentDefinition } from "@plurnk/plurnk-contracts";
+import { AgentCard } from "@a2a-js/sdk";
+export type OutboundAgentDefinition = A2aAgentDefinition;
+export interface HostedAgentConfiguration {
+    readonly host: string;
+    readonly port: number;
+    readonly endpointPath: string;
+    readonly endpointUrl?: string;
+    readonly workspace: {
+        readonly name: string;
+        readonly projectRoot: string | null;
+    };
+    readonly card: AgentCard;
+}
+export declare const outboundAgentNames: (environ?: NodeJS.ProcessEnv) => string[];
+export declare const outboundAgentDefinition: (name: string, environ?: NodeJS.ProcessEnv) => OutboundAgentDefinition | null;
+export declare const outboundDefinitions: (environ?: NodeJS.ProcessEnv) => OutboundAgentDefinition[];
+export declare const serviceEnabledNames: (environ?: NodeJS.ProcessEnv) => string[];
+export declare const hostedAgentConfiguration: (environ?: NodeJS.ProcessEnv) => HostedAgentConfiguration | null;
+export declare const connectTimeoutMs: (environ?: NodeJS.ProcessEnv) => number;
+export declare const requestTimeoutMs: (environ?: NodeJS.ProcessEnv) => number;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEzF,OAAO,EAEH,SAAS,EAEZ,MAAM,aAAa,CAAC;AA2CrB,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,CAAC;AAEzD,MAAM,WAAW,wBAAwB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE;QAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KACvC,CAAC;IACF,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CAC5B;AAqMD,eAAO,MAAM,kBAAkB,aAAa,MAAM,CAAC,UAAU,KAAiB,MAAM,EACxB,CAAC;AAE7D,eAAO,MAAM,uBAAuB,SAC1B,MAAM,YACH,MAAM,CAAC,UAAU,KAC3B,uBAAuB,GAAG,IA+B5B,CAAC;AAEF,eAAO,MAAM,mBAAmB,aACnB,MAAM,CAAC,UAAU,KAC3B,uBAAuB,EAIxB,CAAC;AAEH,eAAO,MAAM,mBAAmB,aAAa,MAAM,CAAC,UAAU,KAAiB,MAAM,EAYpF,CAAC;AAEF,eAAO,MAAM,wBAAwB,aACxB,MAAM,CAAC,UAAU,KAC3B,wBAAwB,GAAG,IAkE7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,aAAa,MAAM,CAAC,UAAU,KAAiB,MACS,CAAC;AAEtF,eAAO,MAAM,gBAAgB,aAAa,MAAM,CAAC,UAAU,KAAiB,MACS,CAAC"}