@undefineds.co/linx 0.2.15 → 0.2.16

package/dist/lib/watch/secretary.js

@@ -0,0 +1,238 @@
+import { createFallbackWatchSecretaryRecommendation, parseWatchGrantCoverageDecision, parseWatchSecretaryRecommendation, } from '@undefineds.co/models/watch';
+import { createRemoteCompletionResult } from '../chat-api.js';
+import { DEFAULT_LINX_CLOUD_MODEL_ID } from '../default-model.js';
+import { getDefaultPodDataSession } from '../pod-data-session.js';
+import { resolveRuntimeTarget } from '../runtime-target.js';
+const SECRETARY_MODEL = DEFAULT_LINX_CLOUD_MODEL_ID;
+const SECRETARY_TIMEOUT_MS = 15_000;
+export async function resolveWatchSecretaryRecommendation(input) {
+    if (input.mode === 'manual') {
+        return null;
+    }
+    try {
+        const session = await getDefaultPodDataSession();
+        if (!session) {
+            return createFallbackWatchSecretaryRecommendation(input);
+        }
+        const target = resolveRuntimeTarget({ issuerUrl: session.credentials.url });
+        const apiKey = await session.getRuntimeAuthToken();
+        const result = await createRemoteCompletionResult({
+            runtimeUrl: target.runtimeUrl,
+            apiKey,
+            model: SECRETARY_MODEL,
+            messages: [
+                {
+                    role: 'system',
+                    content: [
+                        'You are the LinX AI secretary for tool approvals and structured user-input requests.',
+                        'Return strict JSON only.',
+                        'For approvals, choose canAutoDecide=true only when the request is clearly safe, reversible, and sufficiently contextualized.',
+                        'For approvals, decision must be one of "accept", "decline", or "cancel". Never recommend grant, allow_always, accept_for_session, session approval, or long-term authorization.',
+                        'LinX derives the reaction window from confidence and caps it at 60 seconds; do not rely on a model-provided reactionWindowMs.',
+                        'Use canAutoDecide=false when the command is destructive, writes outside the workspace, exposes secrets, changes credentials, installs packages, makes network side effects, or lacks context.',
+                        'For user-input requests, answer only when the answer can be inferred from the provided context. Do not invent secrets, tokens, paths, or user preferences.',
+                        'Schema for approval: {"canAutoDecide":boolean,"decision":"accept|decline|cancel","confidence":0..1,"reason":"short"}.',
+                        'Schema for user-input: {"canAutoDecide":boolean,"answers":{"question_id":{"answers":["value"]}},"confidence":0..1,"reason":"short"}.',
+                    ].join(' '),
+                },
+                {
+                    role: 'user',
+                    content: JSON.stringify(buildSecretaryPayload(input)),
+                },
+            ],
+            signal: AbortSignal.timeout(SECRETARY_TIMEOUT_MS),
+        });
+        return parseWatchSecretaryRecommendation(result.content, {
+            mode: input.mode,
+            request: input.request,
+        }) ?? createFallbackWatchSecretaryRecommendation(input);
+    }
+    catch {
+        return createFallbackWatchSecretaryRecommendation(input);
+    }
+}
+export async function resolveWatchGrantCoverage(input) {
+    if (!hasSemanticGrantPage(input.grant)) {
+        return {
+            covers: false,
+            reason: 'Grant has no semantic wiki page.',
+            source: 'fallback',
+        };
+    }
+    try {
+        const session = await getDefaultPodDataSession();
+        if (!session) {
+            return {
+                covers: false,
+                reason: 'AI secretary is unavailable for semantic grant evaluation.',
+                source: 'fallback',
+            };
+        }
+        const target = resolveRuntimeTarget({ issuerUrl: session.credentials.url });
+        const apiKey = await session.getRuntimeAuthToken();
+        const result = await createRemoteCompletionResult({
+            runtimeUrl: target.runtimeUrl,
+            apiKey,
+            model: SECRETARY_MODEL,
+            messages: [
+                {
+                    role: 'system',
+                    content: [
+                        'You are the LinX AI secretary evaluating whether an existing delegation grant covers a new approval request.',
+                        'Return strict JSON only.',
+                        'A grant is an LLM Wiki page, not a string pattern. Use covers=true only after reading the page body, summary, tags, provenance, and context, and only when the current request clearly fits the documented semantics.',
+                        'Use covers=false when the request changes from read-only to write/destructive behavior, touches credentials/secrets, installs packages, makes new network side effects, changes workspace boundaries, or the wiki page is ambiguous.',
+                        'Schema: {"covers":boolean,"confidence":0..1,"reason":"short"}.',
+                    ].join(' '),
+                },
+                {
+                    role: 'user',
+                    content: JSON.stringify(buildGrantCoveragePayload(input)),
+                },
+            ],
+            signal: AbortSignal.timeout(SECRETARY_TIMEOUT_MS),
+        });
+        return parseWatchGrantCoverageDecision(result.content) ?? {
+            covers: false,
+            reason: 'AI secretary returned an invalid grant coverage decision.',
+            source: 'fallback',
+        };
+    }
+    catch {
+        return {
+            covers: false,
+            reason: 'AI secretary failed during semantic grant evaluation.',
+            source: 'fallback',
+        };
+    }
+}
+function buildSecretaryPayload(input) {
+    return {
+        mode: input.mode,
+        session: {
+            id: input.record.id,
+            backend: input.record.backend,
+            cwd: input.record.cwd,
+            model: input.record.model,
+            credentialSource: input.record.resolvedCredentialSource ?? input.record.credentialSource,
+            approvalSource: input.record.approvalSource,
+        },
+        request: summarizeRequest(input.request),
+    };
+}
+function hasSemanticGrantPage(grant) {
+    return typeof grant.body === 'string' && grant.body.trim().length > 0
+        || typeof grant.policy === 'string' && grant.policy.trim().length > 0;
+}
+function buildGrantCoveragePayload(input) {
+    return {
+        session: input.record ? {
+            id: input.record.id,
+            backend: input.record.backend,
+            cwd: input.record.cwd,
+            model: input.record.model,
+            credentialSource: input.record.resolvedCredentialSource ?? input.record.credentialSource,
+            approvalSource: input.record.approvalSource,
+        } : undefined,
+        grant: summarizeGrant(input.grant),
+        currentRequest: summarizeCoverageRequest(input.request),
+        requestContext: input.requestContext,
+    };
+}
+function summarizeGrant(grant) {
+    return {
+        target: grant.target,
+        action: grant.action,
+        title: grant.title,
+        summary: grant.summary,
+        body: grant.body,
+        schema: grant.schema,
+        pageKind: grant.pageKind,
+        wikiStatus: grant.wikiStatus,
+        tags: parseJsonString(grant.tags) ?? grant.tags,
+        source: grant.source,
+        sourceHash: grant.sourceHash,
+        compiledAt: grant.compiledAt,
+        compiledFrom: grant.compiledFrom,
+        related: grant.related,
+        effect: grant.effect,
+        riskCeiling: grant.riskCeiling,
+        policy: grant.policy,
+        context: parseJsonString(grant.context) ?? grant.context,
+        decisionRole: grant.decisionRole,
+        createdAt: grant.createdAt,
+    };
+}
+function summarizeCoverageRequest(request) {
+    if ('kind' in request && request.kind === 'command-approval') {
+        return {
+            kind: request.kind,
+            message: request.message,
+            command: request.command,
+            cwd: request.cwd,
+            approvalOptions: request.approvalOptions,
+            expiresAt: request.expiresAt,
+        };
+    }
+    if ('kind' in request && request.kind === 'permissions-approval') {
+        return {
+            kind: request.kind,
+            message: request.message,
+            permissions: request.permissions,
+            approvalOptions: request.approvalOptions,
+            expiresAt: request.expiresAt,
+        };
+    }
+    return { ...request };
+}
+function parseJsonString(value) {
+    if (typeof value !== 'string' || !value.trim()) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+function summarizeRequest(request) {
+    if (request.kind === 'user-input') {
+        return {
+            kind: request.kind,
+            message: request.message,
+            questions: request.questions.map((question) => ({
+                id: question.id,
+                header: question.header,
+                question: question.question,
+                options: question.options,
+            })),
+        };
+    }
+    if (request.kind === 'command-approval') {
+        return {
+            kind: request.kind,
+            message: request.message,
+            command: request.command,
+            cwd: request.cwd,
+            approvalOptions: request.approvalOptions,
+            expiresAt: request.expiresAt,
+        };
+    }
+    if (request.kind === 'permissions-approval') {
+        return {
+            kind: request.kind,
+            message: request.message,
+            permissions: request.permissions,
+            approvalOptions: request.approvalOptions,
+            expiresAt: request.expiresAt,
+        };
+    }
+    return {
+        kind: request.kind,
+        message: request.message,
+        approvalOptions: request.approvalOptions,
+        expiresAt: request.expiresAt,
+    };
+}
+//# sourceMappingURL=secretary.js.map

package/dist/lib/watch/secretary.js.map

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

package/dist/watch-cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
-import { formatRemoteWatchApprovalSummary, formatArchivedWatchSession, formatWatchSessionSummary, loadArchivedWatchEvents, listArchivedWatchSessions, listRemoteWatchApprovals, listSupportedWatchBackends, loadArchivedWatchSession, resolveRemoteWatchApproval, runWatch, } from './lib/watch/index.js';
+import { formatArchivedWatchSession, formatWatchSessionSummary, loadArchivedWatchEvents, listArchivedWatchSessions, listSupportedWatchBackends, loadArchivedWatchSession, runWatch, } from './lib/watch/index.js';
 const cli = yargs(hideBin(process.argv))
     .scriptName('linx watch')
     .parserConfiguration({
@@ -10,11 +10,11 @@ const cli = yargs(hideBin(process.argv))
     .command('$0 <action> [backend] [prompt..]', 'Run or inspect local watch backends', (command) => command
     .positional('action', {
     type: 'string',
-    choices: ['run', 'backends', 'sessions', 'show', 'approvals', 'approve', 'reject', 'codex', 'claude', 'codebuddy'],
+    choices: ['run', 'backends', 'sessions', 'show', 'codex', 'claude', 'codebuddy'],
 })
     .positional('backend', {
     type: 'string',
-    describe: 'Watch backend for `run`, session id for `show`, or approval id for `approve|reject`',
+    describe: 'Watch backend for `run` or session id for `show`',
 })
     .option('mode', {
     type: 'string',
@@ -41,14 +41,11 @@ const cli = yargs(hideBin(process.argv))
     choices: ['auto', 'local', 'cloud'],
     describe: 'Resolve credentials only: local CLI login, LinX cloud config, or auto fallback. Runtime still runs locally.',
 })
-    .option('session', {
-    type: 'boolean',
-    default: false,
-    describe: 'Approve for the current watch session instead of only once.',
-})
-    .option('reason', {
+    .option('approval-source', {
     type: 'string',
-    describe: 'Optional note recorded with an approval decision.',
+    default: 'hybrid',
+    choices: ['local', 'remote', 'hybrid'],
+    describe: 'Resolve backend approval requests locally, through Pod remote approvals, or whichever answers first.',
 }), async (argv) => {
     const rawAction = String(argv.action);
     const directBackend = ['codex', 'claude', 'codebuddy'].includes(rawAction);
@@ -85,30 +82,6 @@ const cli = yargs(hideBin(process.argv))
         process.stdout.write(formatArchivedWatchSession(session, loadArchivedWatchEvents(sessionId)));
         return;
     }
-    if (action === 'approvals') {
-        const approvals = await listRemoteWatchApprovals();
-        if (approvals.length === 0) {
-            process.stdout.write('No pending remote approvals in the approval inbox.\n');
-            return;
-        }
-        process.stdout.write(`${approvals.map(formatRemoteWatchApprovalSummary).join('\n')}\n`);
-        return;
-    }
-    if (action === 'approve' || action === 'reject') {
-        const approvalId = argv.backend ? String(argv.backend) : '';
-        if (!approvalId) {
-            throw new Error(`Usage: linx watch ${action} <approvalId>`);
-        }
-        const summary = await resolveRemoteWatchApproval({
-            approvalId,
-            decision: action === 'approve'
-                ? (argv.session ? 'accept_for_session' : 'accept')
-                : 'decline',
-            note: argv.reason ? String(argv.reason) : undefined,
-        });
-        process.stdout.write(`${formatRemoteWatchApprovalSummary(summary)}\n`);
-        return;
-    }
     const backend = (directBackend ? rawAction : argv.backend);
     if (!backend || !['codex', 'claude', 'codebuddy'].includes(backend)) {
         throw new Error('Usage: linx watch run <codex|claude|codebuddy> <prompt> [-- backend args]\n   or: linx watch <codex|claude|codebuddy> <prompt>');
@@ -127,6 +100,7 @@ const cli = yargs(hideBin(process.argv))
         prompt,
         passthroughArgs: (argv['--'] ?? []).map(String),
         credentialSource: argv['credential-source'],
+        approvalSource: argv['approval-source'],
     });
     if (exitCode !== 0) {
         process.exitCode = exitCode;

package/dist/watch-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"watch-cli.js","sourceRoot":"","sources":["../src/watch-cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"watch-cli.js","sourceRoot":"","sources":["../src/watch-cli.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,QAAQ,GAKT,MAAM,sBAAsB,CAAA;AAE7B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;KACrC,UAAU,CAAC,YAAY,CAAC;KACxB,mBAAmB,CAAC;IACnB,YAAY,EAAE,IAAI;CACnB,CAAC;KACD,OAAO,CACN,kCAAkC,EAClC,qCAAqC,EACrC,CAAC,OAAO,EAAE,EAAE,CACV,OAAO;KACJ,UAAU,CAAC,QAAQ,EAAE;IACpB,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAU;CAC1F,CAAC;KACD,UAAU,CAAC,SAAS,EAAE;IACrB,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,kDAAkD;CAC7D,CAAC;KACD,MAAM,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAU;IAC7C,QAAQ,EAAE,uBAAuB;CAClC,CAAC;KACD,MAAM,CAAC,OAAO,EAAE;IACf,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,+BAA+B;CAC1C,CAAC;KACD,MAAM,CAAC,KAAK,EAAE;IACb,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,+CAA+C;CAC1D,CAAC;KACD,MAAM,CAAC,OAAO,EAAE;IACf,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,wDAAwD;CACnE,CAAC;KACD,MAAM,CAAC,mBAAmB,EAAE;IAC3B,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAU;IAC5C,QAAQ,EAAE,6GAA6G;CACxH,CAAC;KACD,MAAM,CAAC,iBAAiB,EAAE;IACzB,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAU;IAC/C,QAAQ,EAAE,sGAAsG;CACjH,CAAC,EACN,KAAK,EAAE,IAAI,EAAE,EAAE;IACb,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACrC,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IAC1E,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;IAEhD,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,0BAA0B,EAAE,CAAA;QAC7C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,KAAK,KAAK,CAAC,CAAA;YACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,WAAW,IAAI,CAAC,CAAA;YAClD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAA;YAC3D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAA;YACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAA;QACzD,CAAC;QACD,OAAM;IACR,CAAC;IAED,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,yBAAyB,EAAE,CAAA;QAC5C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAA;YAClD,OAAM;QACR,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC/E,OAAM;IACR,CAAC;IAED,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAC1D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;QACvD,CAAC;QAED,MAAM,OAAO,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAA;QACnD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,4BAA4B,SAAS,EAAE,CAAC,CAAA;QAC1D,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,OAAO,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;QAC7F,OAAM;IACR,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAA6B,CAAA;IACtF,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,gIAAgI,CAAC,CAAA;IACnJ,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACjC,MAAM,MAAM,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,MAA8B,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,MAA+B,CAAC,IAAI,EAAE,CAAC;SAC5I,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;SAC1D,IAAI,CAAC,GAAG,CAAC;SACT,IAAI,EAAE,IAAI,SAAS,CAAA;IACtB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC;QAC9B,OAAO;QACP,IAAI,EAAE,IAAI,CAAC,IAAiB;QAC5B,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;QAC9B,KAAK;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM;QACN,eAAe,EAAE,CAAE,IAAI,CAAC,IAAI,CAA0B,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;QACzE,gBAAgB,EAAE,IAAI,CAAC,mBAAmB,CAA0B;QACpE,cAAc,EAAE,IAAI,CAAC,iBAAiB,CAAwB;KAC/D,CAAC,CAAA;IAEF,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC7B,CAAC;AACH,CAAC,CACF;KACA,MAAM,EAAE;KACR,IAAI,EAAE,CAAA;AAET,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,KAAc,EAAE,EAAE;IAClD,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA;AAEF,GAAG,CAAC,KAAK,EAAE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@undefineds.co/linx",
-  "version": "0.2.15",
+  "version": "0.2.16",
   "private": false,
   "type": "module",
   "bin": {
@@ -12,7 +12,7 @@
     "test": "yarn build && node --test test/**/*.test.mjs"
   },
   "dependencies": {
-    "@undefineds.co/models": "0.2.15",
+    "@undefineds.co/models": "0.2.16",
     "@inrupt/solid-client-authn-node": "^3.1.1",
     "@mariozechner/pi-coding-agent": "^0.67.6",
     "n3": "^1.26.0",
@@ -25,6 +25,7 @@
   },
   "files": [
     "dist",
+    "vendor",
     "README.md",
     "package.json"
   ],

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

@@ -0,0 +1,27 @@
+export type AgentRuntimeProtocol = 'acp' | 'linx-chatkit' | 'linx-cloud' | 'custom';
+export type AgentRuntimeCapabilityName = 'session.start' | 'session.resume' | 'message.send' | 'message.receive' | 'message.stream' | 'message.thinking' | 'message.inject' | 'tool.call' | 'approval.request' | 'approval.options' | 'input.structured' | 'control.interrupt' | 'control.pause' | 'control.resume' | 'control.stop' | 'model.set';
+export interface AgentRuntimeCapabilities {
+    protocol: AgentRuntimeProtocol;
+    canStartSession: boolean;
+    canResumeSession: boolean;
+    canSendMessage: boolean;
+    canReceiveEvents: boolean;
+    hasStreaming: boolean;
+    hasThinking: boolean;
+    hasToolCalls: boolean;
+    hasApprovals: boolean;
+    hasApprovalOptions: boolean;
+    hasStructuredUserInput: boolean;
+    canInterrupt: boolean;
+    canInjectMessage: boolean;
+    canPause: boolean;
+    canResume: boolean;
+    canStop: boolean;
+    canSetModel: boolean;
+}
+export declare const BASE_ACP_AGENT_CAPABILITIES: AgentRuntimeCapabilities;
+export declare const DEFAULT_LINX_CHATKIT_AGENT_CAPABILITIES: AgentRuntimeCapabilities;
+export declare function defineAgentRuntimeCapabilities(base: AgentRuntimeCapabilities, overrides?: Partial<AgentRuntimeCapabilities>): AgentRuntimeCapabilities;
+export declare function createAcpAgentCapabilities(overrides?: Partial<AgentRuntimeCapabilities>): AgentRuntimeCapabilities;
+export declare function createLinxChatKitAgentCapabilities(overrides?: Partial<AgentRuntimeCapabilities>): AgentRuntimeCapabilities;
+export declare function supportsAgentRuntimeCapability(capabilities: AgentRuntimeCapabilities, capability: AgentRuntimeCapabilityName): boolean;

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

@@ -0,0 +1,86 @@
+export const BASE_ACP_AGENT_CAPABILITIES = {
+    protocol: 'acp',
+    canStartSession: true,
+    canResumeSession: false,
+    canSendMessage: true,
+    canReceiveEvents: true,
+    hasStreaming: true,
+    hasThinking: false,
+    hasToolCalls: true,
+    hasApprovals: true,
+    hasApprovalOptions: true,
+    hasStructuredUserInput: true,
+    canInterrupt: false,
+    canInjectMessage: false,
+    canPause: false,
+    canResume: false,
+    canStop: true,
+    canSetModel: false,
+};
+export const DEFAULT_LINX_CHATKIT_AGENT_CAPABILITIES = {
+    protocol: 'linx-chatkit',
+    canStartSession: true,
+    canResumeSession: true,
+    canSendMessage: true,
+    canReceiveEvents: true,
+    hasStreaming: true,
+    hasThinking: true,
+    hasToolCalls: true,
+    hasApprovals: true,
+    hasApprovalOptions: true,
+    hasStructuredUserInput: true,
+    canInterrupt: true,
+    canInjectMessage: true,
+    canPause: false,
+    canResume: false,
+    canStop: true,
+    canSetModel: true,
+};
+export function defineAgentRuntimeCapabilities(base, overrides = {}) {
+    return {
+        ...base,
+        ...overrides,
+    };
+}
+export function createAcpAgentCapabilities(overrides = {}) {
+    return defineAgentRuntimeCapabilities(BASE_ACP_AGENT_CAPABILITIES, overrides);
+}
+export function createLinxChatKitAgentCapabilities(overrides = {}) {
+    return defineAgentRuntimeCapabilities(DEFAULT_LINX_CHATKIT_AGENT_CAPABILITIES, overrides);
+}
+export function supportsAgentRuntimeCapability(capabilities, capability) {
+    switch (capability) {
+        case 'session.start':
+            return capabilities.canStartSession;
+        case 'session.resume':
+            return capabilities.canResumeSession;
+        case 'message.send':
+            return capabilities.canSendMessage;
+        case 'message.receive':
+            return capabilities.canReceiveEvents;
+        case 'message.stream':
+            return capabilities.hasStreaming;
+        case 'message.thinking':
+            return capabilities.hasThinking;
+        case 'message.inject':
+            return capabilities.canInjectMessage;
+        case 'tool.call':
+            return capabilities.hasToolCalls;
+        case 'approval.request':
+            return capabilities.hasApprovals;
+        case 'approval.options':
+            return capabilities.hasApprovalOptions;
+        case 'input.structured':
+            return capabilities.hasStructuredUserInput;
+        case 'control.interrupt':
+            return capabilities.canInterrupt;
+        case 'control.pause':
+            return capabilities.canPause;
+        case 'control.resume':
+            return capabilities.canResume;
+        case 'control.stop':
+            return capabilities.canStop;
+        case 'model.set':
+            return capabilities.canSetModel;
+    }
+}

package/vendor/agent-runtime/dist/companion-model.d.ts

@@ -0,0 +1,7 @@
+export type AgentRuntimeCompanionTask = 'turn.route' | 'approval.judge' | 'input.answer' | 'context.summarize' | 'title.generate' | 'retrieval.rank';
+export declare const DEFAULT_AGENT_RUNTIME_COMPANION_MODEL_ID = "linx-lite";
+export interface AgentRuntimeCompanionModelPolicy {
+    modelId: string;
+    tasks: AgentRuntimeCompanionTask[];
+}
+export declare const DEFAULT_AGENT_RUNTIME_COMPANION_MODEL_POLICY: AgentRuntimeCompanionModelPolicy;

package/vendor/agent-runtime/dist/companion-model.js

@@ -0,0 +1,12 @@
+export const DEFAULT_AGENT_RUNTIME_COMPANION_MODEL_ID = 'linx-lite';
+export const DEFAULT_AGENT_RUNTIME_COMPANION_MODEL_POLICY = {
+    modelId: DEFAULT_AGENT_RUNTIME_COMPANION_MODEL_ID,
+    tasks: [
+        'turn.route',
+        'approval.judge',
+        'input.answer',
+        'context.summarize',
+        'title.generate',
+        'retrieval.rank',
+    ],
+};

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

@@ -0,0 +1,3 @@
+export * from './acp.js';
+export * from './companion-model.js';
+export * from './turn-controller.js';

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

@@ -0,0 +1,3 @@
+export * from './acp.js';
+export * from './companion-model.js';
+export * from './turn-controller.js';

package/vendor/agent-runtime/dist/turn-controller.d.ts

@@ -0,0 +1,69 @@
+import type { ToolControlCommandName } from '@undefineds.co/models';
+import type { AgentRuntimeCapabilityName } from './acp.js';
+export type AgentParticipantRole = 'user' | 'primary-agent' | 'secretary' | 'system';
+export type AgentTurnTrigger = 'user.message' | 'agent.message' | 'tool.call' | 'approval.required' | 'input.required' | 'grant.coverage.check' | 'session.idle' | 'session.error';
+export type AgentTurnOutputKind = 'chat_message' | 'approval_decision' | 'input_answer' | 'control_command';
+export interface AgentContextWindowPolicy {
+    recentMessages?: number;
+    includeCurrentApproval?: boolean;
+    includeMatchingGrants?: boolean;
+    includeToolCalls?: boolean;
+    includeToolResults?: boolean;
+    includeSystemEvents?: boolean;
+}
+export interface AgentTurnControllerRule {
+    id: string;
+    trigger: AgentTurnTrigger;
+    targetAgent: string;
+    targetRole: AgentParticipantRole;
+    requiredCapabilities?: AgentRuntimeCapabilityName[];
+    context: AgentContextWindowPolicy;
+    allowedOutputs: AgentTurnOutputKind[];
+    allowedControls?: ToolControlCommandName[];
+    requiresUserVisibleTrace?: boolean;
+}
+export interface GroupTurnAgent {
+    id: string;
+    name: string;
+    aliases?: string[];
+    uri?: string;
+    description?: string;
+    tags?: string[];
+    capabilityNames?: string[];
+}
+export interface GroupTurnMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    speaker?: string;
+}
+export interface GroupTurnDecision {
+    shouldReply: boolean;
+    targetAgentIds: string[];
+    reason?: string;
+    confidence?: number;
+}
+export interface GroupTurnRoute {
+    shouldReply: boolean;
+    targetAgentIds: string[];
+    routedBy: 'mention' | 'controller' | 'single-agent' | 'none';
+    coordinationId: string;
+    reason?: string;
+    confidence?: number;
+}
+export interface RouteGroupTurnInput {
+    latestUserMessage: string;
+    agents: GroupTurnAgent[];
+    history?: GroupTurnMessage[];
+    coordinationId?: string;
+    decide?: (input: {
+        latestUserMessage: string;
+        agents: GroupTurnAgent[];
+        history: GroupTurnMessage[];
+    }) => Promise<GroupTurnDecision>;
+}
+export declare function findMentionedGroupAgents(message: string, agents: GroupTurnAgent[]): GroupTurnAgent[];
+export declare function routeGroupTurn(input: RouteGroupTurnInput): Promise<GroupTurnRoute>;
+export declare const GROUP_AGENT_TURN_RULE: AgentTurnControllerRule;
+export declare const WATCH_SECRETARY_APPROVAL_RULE: AgentTurnControllerRule;
+export declare const WATCH_SECRETARY_INPUT_RULE: AgentTurnControllerRule;
+export declare const DEFAULT_WATCH_SECRETARY_RULES: AgentTurnControllerRule[];