@zhivex-ai/core 1.16.0 → 1.17.0

package/dist/agent.d.ts.map

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

package/dist/agent.js

@@ -637,19 +637,19 @@ export const createSubAgentTool = (options) => {
         }
     };
 };
-const saveStateWithRevision = async (store, state) => {
+const saveStateWithRevision = async (store, state, serializedNextState) => {
     const expectedRevision = state.revision ?? 0;
     const nextRevision = expectedRevision + 1;
     const nextState = { ...state, revision: nextRevision };
-    await store.save(cloneState(nextState), { expectedRevision });
+    await store.save(serializedNextState === undefined ? cloneState(nextState) : JSON.parse(serializedNextState), { expectedRevision });
     state.revision = nextRevision;
 };
 const claimAgentExecution = async (agent, state) => {
     state.status = "running";
     state.updatedAt = Date.now();
-    assertStateSize(agent, state);
+    const serialized = assertStateSize(agent, agent.store ? normalizeAgentRunState({ ...state, revision: (state.revision ?? 0) + 1 }) : state);
     if (agent.store) {
-        await saveStateWithRevision(agent.store, state);
+        await saveStateWithRevision(agent.store, state, serialized);
     }
 };
 const assertStateSize = (agent, state, policy) => {
@@ -657,16 +657,18 @@ const assertStateSize = (agent, state, policy) => {
     if (!Number.isSafeInteger(limit) || limit < 1) {
         throw new ValidationError('Agent policy "maxStateBytes" must be a positive integer.');
     }
-    const bytes = new TextEncoder().encode(JSON.stringify(state)).byteLength;
+    const serialized = JSON.stringify(state);
+    const bytes = new TextEncoder().encode(serialized).byteLength;
     if (bytes > limit) {
         throw new ValidationError(`Agent run state is ${bytes} bytes and exceeds maxStateBytes=${limit}. Offload large tool outputs to artifacts or raise the explicit limit.`);
     }
+    return serialized;
 };
 const persistState = async (agent, state, policy) => {
     state.updatedAt = Date.now();
-    assertStateSize(agent, state, policy);
+    const serialized = assertStateSize(agent, agent.store ? normalizeAgentRunState({ ...state, revision: (state.revision ?? 0) + 1 }) : state, policy);
     if (agent.store) {
-        await saveStateWithRevision(agent.store, state);
+        await saveStateWithRevision(agent.store, state, serialized);
     }
     await emitTelemetryEvent(agent, {
         type: "state-saved",
@@ -848,6 +850,11 @@ const resolveContext = async (agent, input) => {
     ensureValidStateInput(normalizedInput);
     const metadata = cloneMetadata(agent.metadata, loadedState?.metadata, input.metadata, input.handoff?.metadata);
     if (loadedState) {
+        const groupIdentity = input.metadata?.agentGroupIdentity;
+        if (groupIdentity !== undefined && (loadedState.metadata?.agentGroupIdentity !== groupIdentity ||
+            loadedState.agentId !== agent.id)) {
+            throw new ConflictError("Agent group idempotency key belongs to a different member or agent.");
+        }
         bindDurableRuntime(agent, input, loadedState, executionEnvironmentBinding);
         const maxSteps = input.maxSteps ?? loadedState.maxSteps;
         const resumed = await applyApprovalResponses(loadedState.messages, input.approvals, loadedState.pendingApprovals, loadedState.approvalHistory, agent.toolApprovalSigner);
@@ -1255,7 +1262,7 @@ const createGenerateOptions = (agent, state, input, messages, maxSteps, context,
     ].filter((value) => value !== undefined);
     const maxTokens = tokenCeilings.length ? Math.min(...tokenCeilings) : undefined;
     const requestedToolExecution = input.toolExecution ?? agent.toolExecution;
-    const toolExecution = agent.subagents?.length
+    const toolExecution = agent.subagents?.length && !(requestedToolExecution?.parallel && requestedToolExecution.independentOnly)
         ? {
             ...requestedToolExecution,
             parallel: false,
@@ -1850,7 +1857,39 @@ export const prepareSubagentsForAgent = (agent, options = {}) => {
     };
 };
 export const runAgentGroup = async (agents, input = {}) => {
-    const { stopOnError, runId: _runId, state: _state, approvals: _approvals, handoff: _handoff, ...sharedInput } = input;
+    const { stopOnError, maxConcurrency, runId: _runId, state: _state, approvals: _approvals, handoff: _handoff, ...sharedInput } = input;
+    if (maxConcurrency !== undefined && (!Number.isSafeInteger(maxConcurrency) || maxConcurrency < 1)) {
+        throw new ValidationError('Agent group "maxConcurrency" must be a positive safe integer.');
+    }
+    // Validate the complete group before any member can claim a key or invoke a model.
+    const identities = new Set();
+    const claims = [];
+    const memberInputs = agents.map((member) => {
+        const merged = { ...sharedInput, ...member.input };
+        ensureValidScope(merged.scope);
+        ensureValidIdempotencyInput(merged, member.agent.store);
+        if (!merged.idempotencyKey)
+            return merged;
+        const identity = member.name ?? member.agent.id;
+        if (!identity || identities.has(identity)) {
+            throw new ValidationError("Idempotent agent group members require unique names or agent IDs.");
+        }
+        identities.add(identity);
+        const key = member.input?.idempotencyKey ?? `agent-group:${JSON.stringify([input.idempotencyKey, identity])}`;
+        const scope = merged.scope;
+        const scopedKey = JSON.stringify([scope?.namespace ?? "default", scope?.tenantId, scope?.userId, key]);
+        if (claims.some((claim) => claim.store === member.agent.store && claim.key === scopedKey)) {
+            throw new ConflictError("Agent group members cannot share an explicit idempotency key in the same store and scope.");
+        }
+        claims.push({ store: member.agent.store, key: scopedKey });
+        return {
+            ...merged,
+            idempotencyKey: key,
+            metadata: cloneMetadata(input.metadata, member.input?.metadata, {
+                agentGroupIdentity: JSON.stringify([input.idempotencyKey ?? null, identity])
+            })
+        };
+    });
     const parentRunId = input.parentRunId;
     const controllers = agents.map(() => new AbortController());
     let failFastTriggered = false;
@@ -1866,15 +1905,17 @@ export const runAgentGroup = async (agents, input = {}) => {
             }
         });
     };
-    const runs = agents.map(async (member, index) => {
+    const runMember = async (member, index) => {
         const merged = createMergedAbortSignal(input.abortSignal, member.input?.abortSignal, controllers[index].signal);
         try {
+            if (merged.signal?.aborted) {
+                throw new DOMException("Agent group member aborted before execution.", "AbortError");
+            }
             const runInput = {
-                ...sharedInput,
-                ...(member.input ?? {}),
+                ...memberInputs[index],
                 parentRunId: member.input?.parentRunId ?? parentRunId,
                 abortSignal: merged.signal,
-                metadata: cloneMetadata(input.metadata, member.input?.metadata, {
+                metadata: cloneMetadata(input.metadata, memberInputs[index]?.metadata, {
                     ...(member.name ? { agentGroupMember: member.name } : {})
                 })
             };
@@ -1891,8 +1932,20 @@ export const runAgentGroup = async (agents, input = {}) => {
         finally {
             merged.cleanup();
         }
-    });
-    const settled = await Promise.allSettled(runs);
+    };
+    const settled = new Array(agents.length);
+    let nextIndex = 0;
+    await Promise.all(Array.from({ length: Math.min(maxConcurrency ?? agents.length, agents.length) }, async () => {
+        while (nextIndex < agents.length) {
+            const index = nextIndex++;
+            try {
+                settled[index] = { status: "fulfilled", value: await runMember(agents[index], index) };
+            }
+            catch (reason) {
+                settled[index] = { status: "rejected", reason };
+            }
+        }
+    }));
     const outputs = settled.map((result, index) => {
         const member = agents[index];
         if (result.status === "fulfilled") {
@@ -1916,9 +1969,12 @@ export const runAgentGroup = async (agents, input = {}) => {
             }
         };
     });
-    const failed = outputs.some((output) => output.status === "rejected" || output.output?.status === "failed" || output.output?.status === "timed_out");
+    const precedence = [
+        "failed", "timed_out", "cancel_requested", "running", "queued", "waiting_approval", "suspended", "cancelled", "completed"
+    ];
+    const status = precedence.find((status) => outputs.some((output) => output.status === "rejected" ? status === "failed" : output.output?.status === status)) ?? "completed";
     return {
-        status: stopOnError && failed ? "failed" : failed ? "failed" : "completed",
+        status,
         parentRunId,
         outputs
     };