@skrr-ai/cli 0.1.116 → 0.1.117

package/dist/lib/task-preflight.js

@@ -22,7 +22,9 @@ function unavailable(error, label) {
             if (typeof body?.code === 'string' && /^[A-Z][A-Z0-9_]{0,100}$/.test(body.code))
                 code = body.code;
         }
-        catch { /* non-JSON server refusal */ }
+        catch {
+            /* non-JSON server refusal */
+        }
     }
     const remedy = status === 401
         ? 'Restore the current CLI sign-in or delegated runtime credential, then repeat this read-only check.'
@@ -32,9 +34,12 @@ function unavailable(error, label) {
                 ? 'Check the Task reference and server support for this diagnostic. No start fallback was attempted.'
                 : 'Read tasks actionability and tasks start --dry-run separately for the native refusal, then repeat preflight after resolving it.';
     return {
-        status: 'unavailable', certainty: 'unknown', code: code || 'TASK_PREFLIGHT_UNAVAILABLE',
+        status: 'unavailable',
+        certainty: 'unknown',
+        code: code || 'TASK_PREFLIGHT_UNAVAILABLE',
         ...(status ? { httpStatus: status } : {}),
-        message: `${label} could not be confirmed${status ? ` (HTTP ${status})` : ''}.`, remedy,
+        message: `${label} could not be confirmed${status ? ` (HTTP ${status})` : ''}.`,
+        remedy,
     };
 }
 function isWorkflow(value, taskId) {
@@ -42,60 +47,92 @@ function isWorkflow(value, taskId) {
         return false;
     const row = value;
     const a = row.actionability;
-    return row.taskId === taskId && Boolean(a &&
-        ['ready', 'running', 'waiting', 'terminal'].includes(a.state) &&
-        ['agent', 'human', 'system', 'external', 'none'].includes(a.nextActor) &&
-        typeof a.reasonCode === 'string' && typeof a.reason === 'string' &&
-        (a.actorRefs === undefined || Array.isArray(a.actorRefs) && a.actorRefs.every(ref => ref && ['user', 'agent'].includes(ref.kind) && typeof ref.id === 'string')) &&
-        Array.isArray(a.allowedActions) && a.allowedActions.every(action => action &&
-        typeof action.action === 'string' && (action.targetId === undefined || typeof action.targetId === 'string')));
+    return (row.taskId === taskId &&
+        Boolean(a &&
+            ['ready', 'running', 'waiting', 'terminal'].includes(a.state) &&
+            ['agent', 'human', 'system', 'external', 'none'].includes(a.nextActor) &&
+            typeof a.reasonCode === 'string' &&
+            typeof a.reason === 'string' &&
+            (a.actorRefs === undefined ||
+                (Array.isArray(a.actorRefs) &&
+                    a.actorRefs.every((ref) => ref && ['user', 'agent'].includes(ref.kind) && typeof ref.id === 'string'))) &&
+            Array.isArray(a.allowedActions) &&
+            a.allowedActions.every((action) => action &&
+                typeof action.action === 'string' &&
+                (action.targetId === undefined || typeof action.targetId === 'string'))));
 }
 function isPreview(value, taskId) {
     if (!(0, task_admission_1.isAdmissionPreview)(value) || value.taskId !== taskId)
         return false;
     const a = value.executionAdmission;
-    return Boolean(typeof a.unattended === 'boolean' && typeof a.approverAvailable === 'boolean' &&
-        (a.constraints === undefined || Array.isArray(a.constraints) && a.constraints.every(c => c &&
-            (c.message === undefined || typeof c.message === 'string') &&
-            (c.requiredAction === undefined || typeof c.requiredAction === 'string'))) &&
-        (a.permission === undefined || a.permission && typeof a.permission === 'object' &&
-            (a.permission.mode == null || typeof a.permission.mode === 'string') &&
-            (a.permission.source === undefined || typeof a.permission.source === 'string')) &&
-        (a.shell === undefined || a.shell && typeof a.shell === 'object' &&
-            (a.shell.state === undefined || typeof a.shell.state === 'string')) &&
-        (a.workingDirectory === undefined || a.workingDirectory &&
-            (a.workingDirectory.path === null || typeof a.workingDirectory.path === 'string') &&
-            typeof a.workingDirectory.source === 'string'));
+    return Boolean(typeof a.unattended === 'boolean' &&
+        typeof a.approverAvailable === 'boolean' &&
+        (a.constraints === undefined ||
+            (Array.isArray(a.constraints) &&
+                a.constraints.every((c) => c &&
+                    (c.message === undefined || typeof c.message === 'string') &&
+                    (c.requiredAction === undefined || typeof c.requiredAction === 'string')))) &&
+        (a.permission === undefined ||
+            (a.permission &&
+                typeof a.permission === 'object' &&
+                (a.permission.mode == null || typeof a.permission.mode === 'string') &&
+                (a.permission.source === undefined || typeof a.permission.source === 'string'))) &&
+        (a.shell === undefined ||
+            (a.shell &&
+                typeof a.shell === 'object' &&
+                (a.shell.state === undefined || typeof a.shell.state === 'string'))) &&
+        (a.workingDirectory === undefined ||
+            (a.workingDirectory &&
+                (a.workingDirectory.path === null || typeof a.workingDirectory.path === 'string') &&
+                typeof a.workingDirectory.source === 'string')));
 }
 /** Compose native reads. This module cannot dispatch execution or infer grants. */
 async function readTaskPreflight(taskId, reads) {
     const [workflowResult, executionResult] = await Promise.allSettled([
-        Promise.resolve().then(reads.workflow), Promise.resolve().then(reads.execution),
+        Promise.resolve().then(reads.workflow),
+        Promise.resolve().then(reads.execution),
     ]);
     const workflow = workflowResult.status === 'fulfilled' && isWorkflow(workflowResult.value, taskId)
         ? { status: 'observed', certainty: 'server_projection', value: workflowResult.value }
-        : unavailable(workflowResult.status === 'rejected' ? workflowResult.reason : { code: 'TASK_ACTIONABILITY_UNSUPPORTED' }, 'Workflow actionability');
+        : unavailable(workflowResult.status === 'rejected'
+            ? workflowResult.reason
+            : { code: 'TASK_ACTIONABILITY_UNSUPPORTED' }, 'Workflow actionability');
     const execution = executionResult.status === 'fulfilled' && isPreview(executionResult.value, taskId)
         ? { status: 'observed', certainty: 'server_projection', value: executionResult.value }
-        : unavailable(executionResult.status === 'rejected' ? executionResult.reason : { code: 'TASK_START_PREVIEW_UNSUPPORTED' }, 'Execution preview');
+        : unavailable(executionResult.status === 'rejected'
+            ? executionResult.reason
+            : { code: 'TASK_START_PREVIEW_UNSUPPORTED' }, 'Execution preview');
     // actionability.revision is the attention revision, not Task.version from
     // start-preview. Equal numbers would not prove the reads shared a snapshot.
     const workflowBlocked = workflow.status === 'observed' &&
-        !workflow.value.actionability.allowedActions.some(action => action.action === 'start_task');
+        !workflow.value.actionability.allowedActions.some((action) => action.action === 'start_task');
     const executionBlocked = execution.status === 'observed' && execution.value.executionAdmission.state === 'blocked';
-    const summary = workflowBlocked || executionBlocked ? 'blocked'
-        : workflow.status === 'unavailable' || execution.status === 'unavailable' ||
-            execution.value.executionAdmission.state !== 'ready' ? 'unknown'
+    const summary = workflowBlocked || executionBlocked
+        ? 'blocked'
+        : workflow.status === 'unavailable' ||
+            execution.status === 'unavailable' ||
+            execution.value.executionAdmission.state !== 'ready'
+            ? 'unknown'
             : 'eligible_to_attempt';
-    return { taskId, summary, workflow, execution, consistency: 'independent_observations', limits: [...LIMITS] };
+    return {
+        taskId,
+        summary,
+        workflow,
+        execution,
+        consistency: 'independent_observations',
+        limits: [...LIMITS],
+    };
 }
 function taskPreflightLines(report, bin = 'skrr') {
-    const lines = [`Task preflight: ${report.taskId}`, `Start eligibility: ${report.summary.replaceAll('_', ' ')} (current server projections)`];
+    const lines = [
+        `Task preflight: ${report.taskId}`,
+        `Start eligibility: ${report.summary.replaceAll('_', ' ')} (current server projections)`,
+    ];
     if (report.workflow.status === 'observed') {
         const a = report.workflow.value.actionability;
         lines.push('', `Workflow: ${a.state} (server projection)`, `Next actor: ${a.nextActor}`, `Why: ${a.reason} [${a.reasonCode}]`);
         if (a.actorRefs?.length)
-            lines.push(`Eligible actors: ${a.actorRefs.map(ref => `${ref.kind}:${ref.id}`).join(', ')}`);
+            lines.push(`Eligible actors: ${a.actorRefs.map((ref) => `${ref.kind}:${ref.id}`).join(', ')}`);
         for (const action of a.allowedActions) {
             const command = (0, task_operations_1.taskActionCommand)(action.action, report.taskId, action.targetId, bin, {
                 allowedActions: a.allowedActions,
@@ -116,6 +153,6 @@ function taskPreflightLines(report, bin = 'skrr') {
     }
     else
         lines.push('', `Execution: unknown. ${report.execution.message} [${report.execution.code}]`, `Next step: ${report.execution.remedy}`);
-    lines.push('', ...report.limits, `More operations: ${bin} tasks guide`);
+    lines.push('', ...report.limits, `More operations: ${bin} guide tasks commands`);
     return lines;
 }

package/dist/lib/usage-discovery.d.ts

@@ -33,6 +33,10 @@ export declare const USAGE_OVERVIEW_TOKEN_BUDGET = 240;
  * `skrr widgets check`, and the app runs in the same frame. Its own overview line took the first read from 240 to 241
  * tokens, and this file's rule for that is to fold into a domain that already has the concept, not to raise the bound.
  * `skrr usage apps` still resolves, to the `widgets` pages, which name it in `Includes:`.
+ * `instruction-blocks` (version-pinned instruction blocks for cloud Agents) is the same concept as
+ * `instructions` (version-pinned blocks for local CLAUDE.md / AGENTS.md), aimed at another target. The overview
+ * read 245 once `skrr guide` joined it, and `guide` stays a line of its own because it is where every operation
+ * guide is read.
  */
 export declare const USAGE_DOMAIN_FOLDS: Readonly<Record<string, string>>;
 export declare const USAGE_DOMAIN_TOKEN_BUDGET = 500;

package/dist/lib/usage-discovery.js

@@ -44,10 +44,15 @@ exports.USAGE_OVERVIEW_TOKEN_BUDGET = 240;
  * `skrr widgets check`, and the app runs in the same frame. Its own overview line took the first read from 240 to 241
  * tokens, and this file's rule for that is to fold into a domain that already has the concept, not to raise the bound.
  * `skrr usage apps` still resolves, to the `widgets` pages, which name it in `Includes:`.
+ * `instruction-blocks` (version-pinned instruction blocks for cloud Agents) is the same concept as
+ * `instructions` (version-pinned blocks for local CLAUDE.md / AGENTS.md), aimed at another target. The overview
+ * read 245 once `skrr guide` joined it, and `guide` stays a line of its own because it is where every operation
+ * guide is read.
  */
 exports.USAGE_DOMAIN_FOLDS = {
     proposals: 'inbox',
     apps: 'widgets',
+    'instruction-blocks': 'instructions',
 };
 exports.USAGE_DOMAIN_TOKEN_BUDGET = 500;
 const GENERIC_FLAGS = new Set(['bare', 'help', 'json', 'token', 'workspace']);

package/dist/lib/voice-call-intent.js

@@ -74,9 +74,11 @@ function readVoiceCallSessionContext(env = process.env) {
     };
 }
 function generatedVoiceCallIdempotencyKey({ context, reason, conversationId, expiresInSeconds, }) {
+    if (!context.requestId)
+        return `voice-call:${crypto.randomUUID()}`;
     const input = [
         context.sessionId,
-        context.requestId || 'no-request-id',
+        context.requestId,
         context.agentId,
         reason,
         conversationId || '',