@undefineds.co/linx 0.3.19 → 0.3.20

package/vendor/agent-runtime/dist/index.d.ts

@@ -4,6 +4,7 @@ export * from './auto-mode.js';
 export * from './companion-model.js';
 export * from './client-inbox-subscription.js';
 export * from './control-plane.js';
+export * from './coordination.js';
 export * from './file-sync.js';
 export * from './reconciler.js';
 export * from './runtime.js';

package/vendor/agent-runtime/dist/index.js

@@ -4,6 +4,7 @@ export * from './auto-mode.js';
 export * from './companion-model.js';
 export * from './client-inbox-subscription.js';
 export * from './control-plane.js';
+export * from './coordination.js';
 export * from './file-sync.js';
 export * from './reconciler.js';
 export * from './runtime.js';

package/vendor/agent-runtime/dist/reconciler.d.ts

@@ -1,4 +1,5 @@
 import type { AgentParticipantRole } from './turn-controller.js';
+import { type ClientReconcilerLease, type ReconcilerOwner } from './coordination.js';
 export type ThreadPolicyKind = 'direct' | 'auto' | 'symphony' | 'open_group' | 'review';
 export type ThreadKind = 'main' | 'control' | 'worker' | 'review' | 'schedule' | 'schedule_run';
 export type ReconcilerEventType = 'message.appended' | 'input.required' | 'approval.required' | 'inbox.notification.created' | 'inbox.notification.updated' | 'delivery.submitted' | 'delivery.completed' | 'delivery.failed' | 'schedule.tick' | 'worker.blocked' | 'change.requested' | 'issue.updated' | 'task.updated' | 'run.updated' | (string & {});
@@ -62,6 +63,9 @@ export interface ThreadControlEvent<TData extends Record<string, unknown> = Reco
 }
 export interface ThreadPolicy {
     kind: ThreadPolicyKind;
+    reconcilerOwner?: ReconcilerOwner;
+    humanAuthorities?: string[];
+    humanAuthorityCount?: number;
     secretaryAgent?: string;
     defaultAssistantAgent?: string;
     assignedWorkerAgent?: string;
@@ -114,6 +118,7 @@ export interface ReconcilerNotificationEvent {
 export interface ReconcileDecision {
     id: string;
     policyKind: ThreadPolicyKind;
+    reconcilerOwner: ReconcilerOwner;
     event: ThreadControlEvent;
     placement: ThreadPlacement;
     wakeJobs: WakeJob[];
@@ -140,6 +145,7 @@ export interface WakeJobSummary {
 export interface ReconcileDecisionSummary {
     id: string;
     policyKind: ThreadPolicyKind;
+    reconcilerOwner: ReconcilerOwner;
     eventType: ReconcilerEventType;
     thread: string;
     chat?: string;
@@ -151,6 +157,11 @@ export interface ReconcileDecisionSummary {
 export interface ReconcileThreadEventInput {
     policy: ThreadPolicyKind | ThreadPolicy;
     event: ThreadControlEvent;
+    reconcilerOwner?: ReconcilerOwner;
+    humanAuthorities?: string[];
+    humanAuthorityCount?: number;
+    clientReconcilerLease?: ClientReconcilerLease | null;
+    requireClientReconcilerLease?: boolean;
     chat?: string;
     thread?: string;
     now?: Date;

package/vendor/agent-runtime/dist/reconciler.js

@@ -1,3 +1,4 @@
+import { canClientCoordinateThread, resolveReconcilerOwnership, } from './coordination.js';
 const DEFAULT_SECRETARY_AGENT = '__secretary__';
 const DEFAULT_ASSISTANT_AGENT = 'primary-agent';
 const DEFAULT_REVIEWER_AGENT = 'ai-reviewer';
@@ -24,12 +25,27 @@ export function reconcileThreadEvent(input) {
         thread: input.thread,
         randomId: input.randomId,
     });
-    const jobs = selectWakeJobs(policy, event, placement, createdAt, input.randomId, input.client);
+    const ownership = resolveReconcilerOwnership({
+        policyKind: policy.kind,
+        humanAuthorities: input.humanAuthorities ?? policy.humanAuthorities,
+        humanAuthorityCount: input.humanAuthorityCount ?? policy.humanAuthorityCount,
+        reconcilerOwner: input.reconcilerOwner ?? policy.reconcilerOwner,
+    });
+    const clientCoordinationSkip = resolveClientCoordinationSkip({
+        ownership,
+        input,
+        placement,
+        createdAt,
+    });
+    const jobs = clientCoordinationSkip
+        ? []
+        : selectWakeJobs(policy, event, placement, createdAt, input.randomId, input.client);
     const notificationEvents = selectNotificationEvents(event, placement, createdAt, input.randomId);
-    const skippedReason = jobs.length === 0 ? skipReasonFor(policy, event, input.client) : undefined;
+    const skippedReason = clientCoordinationSkip ?? (jobs.length === 0 ? skipReasonFor(policy, event, input.client) : undefined);
     return {
         id: createReconcilerId('decision', input.randomId),
         policyKind: policy.kind,
+        reconcilerOwner: ownership.reconcilerOwner,
         event,
         placement,
         wakeJobs: jobs,
@@ -42,6 +58,7 @@ export function summarizeReconcileDecision(decision) {
     return {
         id: decision.id,
         policyKind: decision.policyKind,
+        reconcilerOwner: decision.reconcilerOwner,
         eventType: decision.event.type,
         thread: decision.placement.thread,
         ...(decision.placement.chat ? { chat: decision.placement.chat } : {}),
@@ -120,6 +137,27 @@ export function resolveThreadPlacement(input) {
         kind: 'control',
     };
 }
+function resolveClientCoordinationSkip(input) {
+    if (input.ownership.reconcilerOwner !== 'client') {
+        return undefined;
+    }
+    if (!input.input.requireClientReconcilerLease && !input.input.clientReconcilerLease) {
+        return undefined;
+    }
+    const clientId = input.input.client?.id;
+    if (canClientCoordinateThread({
+        clientId,
+        thread: input.placement.thread,
+        lease: input.input.clientReconcilerLease,
+        now: input.createdAt,
+    })) {
+        return undefined;
+    }
+    const owner = input.input.clientReconcilerLease?.ownerClientId;
+    return owner
+        ? `Client-owned Reconciler is leased by ${owner}; client ${clientId ?? 'unknown'} must not reconcile ${input.placement.thread}.`
+        : `Client-owned Reconciler requires an active client coordinator lease for ${input.placement.thread}.`;
+}
 function selectWakeJobs(policy, event, placement, createdAt, randomId, client) {
     if (policy.kind === 'direct') {
         return isUserMessage(event)
@@ -127,7 +165,7 @@ function selectWakeJobs(policy, event, placement, createdAt, randomId, client) {
                     targetAgent: policy.defaultAssistantAgent ?? DEFAULT_ASSISTANT_AGENT,
                     targetRole: 'primary-agent',
                     priority: 'normal',
-                    reason: 'Direct thread routes user messages to the default assistant.',
+                    reason: 'Single-human assistant surfaces route user messages to the default assistant.',
                     createdAt,
                     randomId,
                 })]

package/vendor/agent-runtime/dist/symphony.d.ts

@@ -11,7 +11,7 @@ export declare const SYMPHONY_ISSUE_FILE_NAME = "issue.json";
 export declare const SYMPHONY_TASK_FILE_NAME = "task.json";
 export declare const SYMPHONY_DELIVERY_FILE_NAME = "delivery.json";
 export declare const SYMPHONY_SESSION_FILE_NAME = "session.json";
-export type SymphonyWorkspaceKind = 'git' | 'folder';
+export type WorkerWorkspaceKind = 'git' | 'folder';
 export type SymphonyIdeaStatus = 'captured' | 'exploring' | 'candidate' | 'promoted' | 'deferred' | 'rejected' | 'superseded';
 export type SymphonyIdeaCommitment = 'thought' | 'direction' | 'tentative_decision' | 'committed';
 export type SymphonyIssueStatus = 'open' | 'triaging' | 'in_progress' | 'blocked' | 'resolved' | 'closed';
@@ -23,13 +23,13 @@ export type SymphonyResourceKind = 'idea' | 'issue' | 'task' | 'delivery' | 'ses
 export interface SymphonyReconcilerState {
     decisions: ReconcileDecisionSummary[];
 }
-export interface SymphonyWorkspaceRef {
+export interface WorkerWorkspaceRef {
     path: string;
-    kind: SymphonyWorkspaceKind;
+    kind: WorkerWorkspaceKind;
     repository?: string;
     branch?: string;
     worktree?: string;
-    workspaceUri?: string;
+    workspace?: string;
     baseRevision?: string;
     environment?: SymphonyWorkerEnvironmentRef;
 }
@@ -147,7 +147,7 @@ export interface SymphonySessionRecord extends SymphonyChatThreadRef {
     secretaryAutoEnabled?: boolean;
     status: SymphonySessionStatus;
     cwd: string;
-    workspace?: SymphonyWorkspaceRef;
+    workspaceRef?: WorkerWorkspaceRef;
     target: SymphonyDelegationTarget;
     model?: string;
     supervisor?: SymphonySupervisorPolicy;
@@ -180,18 +180,18 @@ export interface SymphonyWorkerSpec extends Partial<SymphonyDelegationTarget> {
     acceptanceCriteria?: string[];
     model?: string;
     supervisorIntervalMs?: number;
-    workspace?: Partial<SymphonyWorkspaceRef>;
+    workspace?: Partial<WorkerWorkspaceRef>;
 }
 export interface CreateSymphonyRunPlanInput {
     objective: string;
     title?: string;
     acceptanceCriteria?: string[];
     workspacePath: string;
-    workspaceKind?: SymphonyWorkspaceKind;
+    workspaceKind?: WorkerWorkspaceKind;
     repository?: string;
     branch?: string;
     worktree?: string;
-    workspaceUri?: string;
+    workspace?: string;
     baseRevision?: string;
     environment?: Partial<SymphonyWorkerEnvironmentRef>;
     backend: AutoModeWorkerBackend;
@@ -242,7 +242,7 @@ export declare function renderSymphonyRuntimePrompt(input: {
     task: string;
     objective: string;
     acceptanceCriteria?: string[];
-    workspace: SymphonyWorkspaceRef;
+    workspace: WorkerWorkspaceRef;
     backend: AutoModeWorkerBackend;
     mode: AutoModeMode;
     secretaryAutoEnabled?: boolean;

package/vendor/agent-runtime/dist/symphony.js

@@ -72,7 +72,7 @@ export function createRunPlan(input) {
         ...(normalizeOptionalText(input.repository) ? { repository: normalizeOptionalText(input.repository) } : {}),
         ...(normalizeOptionalText(input.branch) ? { branch: normalizeOptionalText(input.branch) } : {}),
         ...(normalizeOptionalText(input.worktree) ? { worktree: normalizeOptionalText(input.worktree) } : {}),
-        ...(normalizeOptionalText(input.workspaceUri) ? { workspaceUri: normalizeOptionalText(input.workspaceUri) } : {}),
+        ...(normalizeOptionalText(input.workspace) ? { workspace: normalizeOptionalText(input.workspace) } : {}),
         ...(normalizeOptionalText(input.baseRevision) ? { baseRevision: normalizeOptionalText(input.baseRevision) } : {}),
         environment: normalizeSymphonyWorkerEnvironment(input.environment, input.backend),
     };
@@ -146,7 +146,7 @@ export function createRunPlan(input) {
             ...(input.secretaryAutoEnabled !== undefined ? { secretaryAutoEnabled: input.secretaryAutoEnabled } : {}),
             status: 'planned',
             cwd: workerWorkspace.path,
-            workspace: workerWorkspace,
+            workspaceRef: workerWorkspace,
             target,
             ...(spec.model ? { model: spec.model } : {}),
             ...(spec.supervisor ? { supervisor: spec.supervisor } : {}),
@@ -239,7 +239,7 @@ export function renderSymphonyRuntimePrompt(input) {
         ...(workThread ? [`Work thread: ${workThread}`] : []),
         `Workspace: ${input.workspace.path}`,
         `Workspace kind: ${input.workspace.kind}`,
-        ...(input.workspace.workspaceUri ? [`Workspace URI: ${input.workspace.workspaceUri}`] : []),
+        ...(input.workspace.workspace ? [`Workspace resource: ${input.workspace.workspace}`] : []),
         ...(input.workspace.repository ? [`Workspace repository: ${input.workspace.repository}`] : []),
         ...(input.workspace.branch ? [`Workspace branch: ${input.workspace.branch}`] : []),
         ...(input.workspace.baseRevision ? [`Workspace base revision: ${input.workspace.baseRevision}`] : []),
@@ -406,7 +406,7 @@ function normalizeSymphonyWorkerWorkspace(root, override, backend) {
         ...(normalizeOptionalText(override?.repository ?? root.repository) ? { repository: normalizeOptionalText(override?.repository ?? root.repository) } : {}),
         ...(normalizeOptionalText(override?.branch ?? root.branch) ? { branch: normalizeOptionalText(override?.branch ?? root.branch) } : {}),
         ...(normalizeOptionalText(override?.worktree ?? root.worktree) ? { worktree: normalizeOptionalText(override?.worktree ?? root.worktree) } : {}),
-        ...(normalizeOptionalText(override?.workspaceUri ?? root.workspaceUri) ? { workspaceUri: normalizeOptionalText(override?.workspaceUri ?? root.workspaceUri) } : {}),
+        ...(normalizeOptionalText(override?.workspace ?? root.workspace) ? { workspace: normalizeOptionalText(override?.workspace ?? root.workspace) } : {}),
         ...(normalizeOptionalText(override?.baseRevision ?? root.baseRevision) ? { baseRevision: normalizeOptionalText(override?.baseRevision ?? root.baseRevision) } : {}),
         environment: normalizeSymphonyWorkerEnvironment(override?.environment ?? root.environment, backend),
     };