@skrr-ai/cli 0.1.85 → 0.1.86

package/dist/commands/agents/endpoint/enable.js

@@ -40,6 +40,12 @@ class AgentsEndpointEnable extends base_command_1.BaseCommand {
         }
         (0, agent_endpoints_1.printAgentEndpoint)(this, endpoint);
         this.log('');
+        if (!(0, agent_endpoints_1.endpointWillRun)(endpoint)) {
+            // On is not the same as runnable: say so rather than end on a connect
+            // line that leads to a refused first call (OSK-13521).
+            this.log(endpoint.notice ||
+                `The endpoint is on, but it will not run a turn until ${endpoint.blocked_by?.code ?? 'its blocker'} clears.`);
+        }
         this.log('Connect a client with: skrr agents endpoint connect ' + args.id + ' --space <space-id>');
     }
 }

package/dist/commands/store/acquisitions/approve.js

@@ -66,6 +66,9 @@ class StoreAcquisitionsApprove extends base_command_1.BaseCommand {
                 exit: 1,
             });
         }
+        if (request.invalidReason === 'buyer_terms_missing') {
+            this.error(`This request was recorded without buyer terms, so it cannot be approved. Decline it with \`skrr store acquisitions decline ${request.id}\`; the agent's next attempt opens a new request that carries the terms.`, { exit: 1 });
+        }
         if (!request.buyerTerms) {
             this.error('Buyer terms are not configured, so this purchase cannot be approved.', {
                 exit: 1,

package/dist/lib/agent-endpoints.d.ts

@@ -23,11 +23,14 @@ export interface AgentEndpoint {
     enabled_at?: string | null;
     switchable: boolean;
     ready: boolean;
-    /** The gate that would refuse a turn right now (see docs/cli/SKRR_AGENT_ENDPOINTS.md). */
-    blocked_by: {
-        code: string;
-        message: string;
-    } | null;
+    /**
+     * The gate that would refuse a turn right now (see docs/cli/SKRR_AGENT_ENDPOINTS.md).
+     * Includes the agent-worker runtime admission endpoint turns run on — e.g.
+     * `RUNTIME_METERING_BACKLOG_BLOCKED` — with the next step in `remedy`.
+     */
+    blocked_by: AgentEndpointBlocker | null;
+    /** Set by `enable` when the endpoint is on but a turn would still be refused. */
+    notice?: string;
     release?: {
         id: string;
         version_label: string | null;
@@ -44,6 +47,12 @@ export interface AgentEndpoint {
     };
     workspace_id?: string | null;
 }
+export interface AgentEndpointBlocker {
+    code: string;
+    message: string;
+    remedy?: string | null;
+    details?: Record<string, unknown>;
+}
 export declare function getAgentEndpoint(agentId: string): Promise<AgentEndpoint>;
 /** Turn a Store instance's endpoint on or off. Owner only, enforced server-side. */
 export declare function setAgentEndpointEnabled(agentId: string, enabled: boolean): Promise<AgentEndpoint>;
@@ -56,6 +65,11 @@ export declare const AGENT_ENDPOINT_SCOPE = "agents:invoke";
 export declare function mcpClientCommand(endpoint: AgentEndpoint, secret: string): string;
 /** One human line for the state an endpoint is in. */
 export declare function describeEndpointState(endpoint: AgentEndpoint): string;
+/**
+ * Whether the endpoint would run a turn now. `ready` alone is the answer; this
+ * exists so a caller never reads `enabled` as "it works" (OSK-13521).
+ */
+export declare function endpointWillRun(endpoint: AgentEndpoint): boolean;
 /** The human rendering every `agents endpoint` command prints. */
 export declare function printAgentEndpoint(cmd: {
     log: (line: string) => void;

package/dist/lib/agent-endpoints.js

@@ -5,6 +5,7 @@ exports.getAgentEndpoint = getAgentEndpoint;
 exports.setAgentEndpointEnabled = setAgentEndpointEnabled;
 exports.mcpClientCommand = mcpClientCommand;
 exports.describeEndpointState = describeEndpointState;
+exports.endpointWillRun = endpointWillRun;
 exports.printAgentEndpoint = printAgentEndpoint;
 const api_fetch_1 = require("./api-fetch");
 async function getAgentEndpoint(agentId) {
@@ -40,11 +41,21 @@ function describeEndpointState(endpoint) {
     }
     return 'on';
 }
+/**
+ * Whether the endpoint would run a turn now. `ready` alone is the answer; this
+ * exists so a caller never reads `enabled` as "it works" (OSK-13521).
+ */
+function endpointWillRun(endpoint) {
+    return endpoint.enabled && endpoint.ready && !endpoint.blocked_by;
+}
 /** The human rendering every `agents endpoint` command prints. */
 function printAgentEndpoint(cmd, endpoint) {
     cmd.log(`Agent     ${endpoint.agent_id}${endpoint.agent_name ? ` (${endpoint.agent_name})` : ''}`);
     cmd.log(`Kind      ${endpoint.kind.replace(/_/g, ' ')}`);
     cmd.log(`Endpoint  ${describeEndpointState(endpoint)}`);
+    if (endpoint.blocked_by?.remedy) {
+        cmd.log(`Next step ${endpoint.blocked_by.remedy}`);
+    }
     if (endpoint.url) {
         cmd.log(`URL       ${endpoint.url}  (MCP, ${endpoint.transport})`);
         cmd.log(`Key scope ${endpoint.scope}`);

package/dist/lib/store-acquisition.js

@@ -3,6 +3,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.describeAcquisitionRequestLines = describeAcquisitionRequestLines;
 exports.describeAcquisitionRequestRow = describeAcquisitionRequestRow;
 const data_provider_1 = require("@skrr-ai/data-provider");
+function describeBuyerTerms(request) {
+    if (request.buyerTerms) {
+        return `${request.buyerTerms.termsVersion} — ${request.buyerTerms.artifactUri}`;
+    }
+    if (request.invalidReason === 'buyer_terms_missing') {
+        // Stored before OSK-13520 refused to open a request without terms.
+        return 'missing — this request was recorded without buyer terms, so it can only be declined';
+    }
+    return 'not configured, so this purchase cannot be approved';
+}
 /**
  * A purchase an agent asked to make, as the lines a terminal shows (OSK-12240).
  *
@@ -22,9 +32,7 @@ function describeAcquisitionRequestLines(request) {
         `  Status:       ${status.label}${status.detail ? ` — ${status.detail}` : ''}`,
         `  Price:        ${(0, data_provider_1.formatStoreAcquisitionPrice)(request.price)} ${request.currency}`,
         `  Refunds:      ${(0, data_provider_1.describeStoreAcquisitionRefundTerms)(request.refundTerms)}`,
-        `  Buyer terms:  ${request.buyerTerms
-            ? `${request.buyerTerms.termsVersion} — ${request.buyerTerms.artifactUri}`
-            : 'not configured, so this purchase cannot be approved'}`,
+        `  Buyer terms:  ${describeBuyerTerms(request)}`,
         `  Offer:        ${request.offerVersionId}`,
         `  Capabilities: ${(0, data_provider_1.describeStoreAcquisitionCapabilities)(request.capabilities, request.capabilityCount)}`,
     ];