@zenalexa/unicli 0.222.0 → 0.222.1

package/dist/engine/delivery/trajectory.js

@@ -0,0 +1,166 @@
+/**
+ * @owner   src/engine/delivery/trajectory.ts
+ * @does    Converts delivery state into a reviewable experiment trajectory with observations, hypotheses, and the next executable experiment.
+ * @needs   src/engine/delivery/planner.ts, src/engine/delivery/types.ts
+ * @feeds   future delivery ledgers, repair bridge, and operator CLI summaries.
+ * @breaks  Trajectory output becomes misleading if assessment statuses stop mapping to verification and failure classifications.
+ * @invariants non-active assessments never produce next executable experiments.
+ * @side-effects none
+ * @perf    O(attempts log attempts + strategies + gates) per trajectory.
+ * @concurrency pure and reentrant.
+ * @test    tests/unit/engine-delivery-trajectory.test.ts
+ * @stability experimental
+ * @since   2026-05-24
+ */
+import { assessDeliveryState, diagnoseDeliveryAttempt, evaluateDeliveryGates, } from "./planner.js";
+export function buildDeliveryTrajectory(input) {
+    const assessment = assessDeliveryState(input);
+    const strategiesById = new Map(input.strategies.map((strategy) => [strategy.id, strategy]));
+    const trials = [...input.attempts]
+        .sort((left, right) => left.ordinal - right.ordinal)
+        .map((attempt) => {
+        const gateResults = evaluateDeliveryGates(input.objective, attempt);
+        return trialRecordFromAttempt({
+            attempt,
+            assessment: attempt.id === assessment.current_attempt_id ? assessment : undefined,
+            gateResults,
+        });
+    });
+    const verificationStatus = verificationStatusFromAssessment(assessment);
+    const nextExperiment = verificationStatus === "active"
+        ? nextExperimentFromAssessment(assessment, strategiesById)
+        : undefined;
+    return {
+        schema_version: "1",
+        objective_id: input.objective.id,
+        goal: input.objective.goal,
+        recorded_at: input.recorded_at ?? new Date().toISOString(),
+        verification_status: verificationStatus,
+        assessment,
+        trials,
+        ...(nextExperiment ? { next_experiment: nextExperiment } : {}),
+    };
+}
+function trialRecordFromAttempt(input) {
+    const failedGates = input.gateResults
+        .filter((gate) => !gate.passed)
+        .map((gate) => gate.name);
+    const status = input.assessment?.status ?? trialStatus(input.attempt, failedGates);
+    const diagnosis = input.assessment?.diagnosis ??
+        diagnosisForHistoricalAttempt(input.attempt, input.gateResults, failedGates);
+    const verificationStatus = verificationStatusFromTrial(status);
+    return {
+        id: input.attempt.id,
+        ordinal: input.attempt.ordinal,
+        run_id: input.attempt.run_id,
+        strategy_id: input.attempt.strategy_id,
+        status,
+        verification_status: verificationStatus,
+        failed_gates: failedGates,
+        classification: classifyTrial(diagnosis?.code, status),
+        ...(diagnosis?.code ? { diagnosis_code: diagnosis.code } : {}),
+        hypothesis: input.assessment?.hypothesis?.reason,
+    };
+}
+function diagnosisForHistoricalAttempt(attempt, gateResults, failedGates) {
+    if (failedGates.length === 0 &&
+        !attempt.error &&
+        !attempt.summary.runtime_permission_denied) {
+        return undefined;
+    }
+    return diagnoseDeliveryAttempt(attempt, gateResults);
+}
+function nextExperimentFromAssessment(assessment, strategiesById) {
+    const strategyId = assessment.next_strategy_id ?? assessment.hypothesis?.strategy_id;
+    if (!strategyId)
+        return undefined;
+    const strategy = strategiesById.get(strategyId);
+    if (!strategy)
+        return undefined;
+    return {
+        action: assessment.next_action,
+        strategy_id: strategy.id,
+        ...(strategy.command ? { command: strategy.command } : {}),
+        ...(assessment.hypothesis?.target
+            ? { target: assessment.hypothesis.target }
+            : strategy.adapter_path
+                ? { target: strategy.adapter_path }
+                : {}),
+        ...(strategy.verify_command
+            ? { verify_command: strategy.verify_command }
+            : {}),
+        disproof: disproofForAction(assessment.next_action),
+    };
+}
+function verificationStatusFromAssessment(assessment) {
+    switch (assessment.status) {
+        case "delivered":
+            return "verified";
+        case "blocked":
+            return "blocked";
+        case "exhausted":
+            return "exhausted";
+        case "ready":
+        case "needs_retry":
+        case "needs_repair":
+        case "inconclusive":
+            return "active";
+    }
+}
+function verificationStatusFromTrial(status) {
+    switch (status) {
+        case "delivered":
+            return "verified";
+        case "blocked":
+            return "blocked";
+        case "exhausted":
+            return "exhausted";
+        case "ready":
+        case "needs_retry":
+        case "needs_repair":
+        case "inconclusive":
+            return "active";
+    }
+}
+function trialStatus(attempt, failedGates) {
+    return attempt.summary.status === "completed" && failedGates.length === 0
+        ? "delivered"
+        : "inconclusive";
+}
+function classifyTrial(diagnosisCode, status) {
+    if (status === "delivered")
+        return "inconclusive";
+    switch (diagnosisCode) {
+        case "adapter_drift":
+        case "output_contract_mismatch":
+        case "evidence_gate_failed":
+            return "product_defect";
+        case "auth_required":
+            return "missing_context";
+        case "permission_denied":
+            return "user_or_policy_block";
+        case "transient_upstream":
+            return "upstream_or_environment";
+        case "strategy_exhausted":
+        case "unknown_failure":
+        default:
+            return "inconclusive";
+    }
+}
+function disproofForAction(action) {
+    switch (action) {
+        case "repair_adapter":
+            return "The next run still fails the same evidence gates or diagnosis.";
+        case "retry_strategy":
+            return "A repeated run still fails the same evidence gates.";
+        case "switch_strategy":
+        case "run_strategy":
+            return "The selected strategy cannot satisfy the objective evidence gates.";
+        case "request_auth":
+        case "request_permission":
+        case "inspect_failure":
+        case "stop":
+            return "No executable experiment is available from this assessment.";
+    }
+}
+//# sourceMappingURL=trajectory.js.map

package/dist/engine/delivery/trajectory.js.map

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

package/dist/engine/delivery/types.d.ts

@@ -0,0 +1,157 @@
+/**
+ * @owner   src/engine/delivery/types.ts
+ * @does    Defines objective-level delivery contracts: strategies, attempts, evidence gates, diagnoses, and next actions.
+ * @needs   src/output/envelope.ts, src/engine/session/query.ts, src/engine/session/types.ts
+ * @feeds   src/engine/delivery/planner.ts, src/engine/delivery/repair.ts, and future objective-level CLI orchestration.
+ * @breaks  Misclassified status fields can make repairable, retryable, and blocked failures indistinguishable.
+ * @invariants repair candidates require both an adapter path and verification command.
+ * @side-effects none
+ * @perf    type-only module.
+ * @concurrency type-only module.
+ * @test    tests/unit/engine-delivery*.test.ts
+ * @stability experimental
+ * @since   2026-05-24
+ */
+import type { AgentError } from "../../output/envelope.js";
+import type { RunSummary } from "../session/query.js";
+import type { RunEvent, RunId } from "../session/types.js";
+export type DeliveryStrategyKind = "adapter" | "browser" | "desktop" | "local" | "mcp" | "manual";
+export interface DeliveryStrategy {
+    id: string;
+    kind: DeliveryStrategyKind;
+    label: string;
+    priority: number;
+    enabled?: boolean;
+    command?: string;
+    args?: Record<string, unknown>;
+    adapter_path?: string;
+    verify_command?: string;
+}
+export interface DeliveryAttemptBudget {
+    max_attempts?: number;
+    max_attempts_per_strategy?: number;
+}
+export type DeliveryEvidenceGate = {
+    kind: "run_completed";
+} | {
+    kind: "min_evidence_count";
+    min: number;
+} | {
+    kind: "required_evidence_type";
+    evidence_type: string;
+    min?: number;
+};
+export interface DeliveryObjective {
+    id: string;
+    goal: string;
+    evidence_gates?: DeliveryEvidenceGate[];
+    attempt_budget?: DeliveryAttemptBudget;
+}
+export interface DeliveryAttempt {
+    id: string;
+    ordinal: number;
+    strategy_id: string;
+    run_id: RunId;
+    summary: RunSummary;
+    error?: AgentError;
+}
+export interface DeliveryGateResult {
+    name: string;
+    kind: DeliveryEvidenceGate["kind"];
+    passed: boolean;
+    expected: string | number;
+    actual: string | number;
+}
+export type DeliveryDiagnosisCode = "adapter_drift" | "auth_required" | "evidence_gate_failed" | "output_contract_mismatch" | "permission_denied" | "strategy_exhausted" | "transient_upstream" | "unknown_failure";
+export interface DeliveryDiagnosis {
+    code: DeliveryDiagnosisCode;
+    reason: string;
+    repairable: boolean;
+    retryable: boolean;
+    adapter_path?: string;
+    step?: number;
+    suggestion?: string;
+}
+export type DeliveryStatus = "ready" | "delivered" | "needs_retry" | "needs_repair" | "blocked" | "exhausted" | "inconclusive";
+export type DeliveryNextAction = "run_strategy" | "stop" | "retry_strategy" | "repair_adapter" | "switch_strategy" | "request_auth" | "request_permission" | "inspect_failure";
+export interface DeliveryHypothesis {
+    id: string;
+    diagnosis_code: DeliveryDiagnosisCode;
+    action: DeliveryNextAction;
+    reason: string;
+    strategy_id?: string;
+    target?: string;
+    verify_command?: string;
+}
+export interface DeliveryAssessment {
+    objective_id: string;
+    status: DeliveryStatus;
+    next_action: DeliveryNextAction;
+    gates: DeliveryGateResult[];
+    current_attempt_id?: string;
+    current_strategy_id?: string;
+    next_strategy_id?: string;
+    diagnosis?: DeliveryDiagnosis;
+    hypothesis?: DeliveryHypothesis;
+}
+export interface DeliveryStateInput {
+    objective: DeliveryObjective;
+    strategies: DeliveryStrategy[];
+    attempts: DeliveryAttempt[];
+}
+export type DeliveryVerificationStatus = "unverified" | "active" | "verified" | "blocked" | "exhausted";
+export type DeliveryFailureClassification = "product_defect" | "missing_context" | "user_or_policy_block" | "upstream_or_environment" | "inconclusive";
+export interface DeliveryTrialRecord {
+    id: string;
+    ordinal: number;
+    run_id: RunId;
+    strategy_id: string;
+    status: DeliveryStatus;
+    verification_status: DeliveryVerificationStatus;
+    failed_gates: string[];
+    classification: DeliveryFailureClassification;
+    diagnosis_code?: DeliveryDiagnosisCode;
+    hypothesis?: string;
+}
+export interface DeliveryNextExperiment {
+    action: DeliveryNextAction;
+    strategy_id: string;
+    command?: string;
+    target?: string;
+    verify_command?: string;
+    disproof: string;
+}
+export interface DeliveryTrajectory {
+    schema_version: "1";
+    objective_id: string;
+    goal: string;
+    recorded_at: string;
+    verification_status: DeliveryVerificationStatus;
+    assessment: DeliveryAssessment;
+    trials: DeliveryTrialRecord[];
+    next_experiment?: DeliveryNextExperiment;
+}
+export interface DeliveryTrajectoryInput extends DeliveryStateInput {
+    recorded_at?: string;
+}
+export interface DeliveryAttemptFromRunEventsInput {
+    id: string;
+    ordinal: number;
+    strategy_id: string;
+    events: RunEvent[];
+    run_id?: RunId;
+}
+export interface DeliveryRepairCandidate {
+    schema_version: "1";
+    objective_id: string;
+    attempt_id: string;
+    strategy_id: string;
+    adapter_path: string;
+    verify_command: string;
+    diagnosis_code: DeliveryDiagnosisCode;
+    reason: string;
+    command?: string;
+    step?: number;
+    suggestion?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/engine/delivery/types.d.ts.map

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

package/dist/engine/delivery/types.js

@@ -0,0 +1,16 @@
+/**
+ * @owner   src/engine/delivery/types.ts
+ * @does    Defines objective-level delivery contracts: strategies, attempts, evidence gates, diagnoses, and next actions.
+ * @needs   src/output/envelope.ts, src/engine/session/query.ts, src/engine/session/types.ts
+ * @feeds   src/engine/delivery/planner.ts, src/engine/delivery/repair.ts, and future objective-level CLI orchestration.
+ * @breaks  Misclassified status fields can make repairable, retryable, and blocked failures indistinguishable.
+ * @invariants repair candidates require both an adapter path and verification command.
+ * @side-effects none
+ * @perf    type-only module.
+ * @concurrency type-only module.
+ * @test    tests/unit/engine-delivery*.test.ts
+ * @stability experimental
+ * @since   2026-05-24
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/engine/delivery/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/engine/delivery/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.222.0",
+  "version": "0.222.1",
   "sites": {
     "1688": {
       "commands": [
@@ -20732,7 +20732,7 @@
           "type": "web-api",
           "domain": "www.instagram.com",
           "browser": false,
-          "quarantined": false,
+          "quarantined": true,
           "args": [
             {
               "name": "limit",

package/dist/output/error-writer.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @owner   src/output/error-writer.ts
+ * @does    Centralizes process-level emission of structured AgentEnvelope errors.
+ * @needs   src/output/formatter.ts, src/output/envelope.ts, src/types.ts
+ * @feeds   command modules that need stderr error envelopes with explicit exit codes.
+ * @breaks  Writing errors to stdout pollutes agent data streams and violates the CLI contract.
+ * @invariants error envelopes always go to stderr; process.exitCode is set before emission.
+ * @side-effects writes to stderr and sets process.exitCode.
+ * @perf    O(serialized envelope size).
+ * @concurrency process-global exitCode and stderr make this CLI-process scoped.
+ * @test    tests/unit/delivery-cli.test.ts, tests/unit/session-runs-command.test.ts, tests/unit/commands/extract.test.ts
+ * @stability experimental
+ * @since   2026-05-24
+ */
+import type { AgentContext } from "./envelope.js";
+import type { OutputFormat } from "../types.js";
+export declare function printErrorEnvelope(input: {
+    columns?: string[];
+    fmt: OutputFormat;
+    ctx: AgentContext;
+    exitCode: number;
+}): void;
+//# sourceMappingURL=error-writer.d.ts.map

package/dist/output/error-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-writer.d.ts","sourceRoot":"","sources":["../../src/output/error-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,EAAE,YAAY,CAAC;IAClB,GAAG,EAAE,YAAY,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAGP"}

package/dist/output/error-writer.js

@@ -0,0 +1,20 @@
+/**
+ * @owner   src/output/error-writer.ts
+ * @does    Centralizes process-level emission of structured AgentEnvelope errors.
+ * @needs   src/output/formatter.ts, src/output/envelope.ts, src/types.ts
+ * @feeds   command modules that need stderr error envelopes with explicit exit codes.
+ * @breaks  Writing errors to stdout pollutes agent data streams and violates the CLI contract.
+ * @invariants error envelopes always go to stderr; process.exitCode is set before emission.
+ * @side-effects writes to stderr and sets process.exitCode.
+ * @perf    O(serialized envelope size).
+ * @concurrency process-global exitCode and stderr make this CLI-process scoped.
+ * @test    tests/unit/delivery-cli.test.ts, tests/unit/session-runs-command.test.ts, tests/unit/commands/extract.test.ts
+ * @stability experimental
+ * @since   2026-05-24
+ */
+import { format } from "./formatter.js";
+export function printErrorEnvelope(input) {
+    process.exitCode = input.exitCode;
+    console.error(format(null, input.columns, input.fmt, input.ctx));
+}
+//# sourceMappingURL=error-writer.js.map

package/dist/output/error-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-writer.js","sourceRoot":"","sources":["../../src/output/error-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC,MAAM,UAAU,kBAAkB,CAAC,KAKlC;IACC,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAClC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zenalexa/unicli",
-  "version": "0.222.0",
-  "description": "Agent execution substrate for web, apps, local tools, and system capabilities. Self-repairing CLI catalog with stdio + Streamable HTTP MCP server.",
+  "version": "0.222.1",
+  "description": "Operations substrate for agents that use real software: web, browsers, desktop apps, local tools, MCP, policy, evidence, and self-repair.",
   "packageManager": "npm@11.14.0",
   "type": "module",
   "main": "dist/main.js",

package/server.json

@@ -2,7 +2,7 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
   "name": "io.github.olo-dot-io/Uni-CLI",
   "description": "Self-repairing CLI catalog that exposes 282 websites, desktop apps, and external CLIs as one MCP server. 949 declarative YAML adapters and 1686 commands; structured error envelopes let agents fix failing adapters at runtime and retry.",
-  "version": "0.222.0",
+  "version": "0.222.1",
   "repository": {
     "url": "https://github.com/olo-dot-io/Uni-CLI",
     "source": "github"
@@ -13,7 +13,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@zenalexa/unicli",
-      "version": "0.222.0",
+      "version": "0.222.1",
       "transport": {
         "type": "stdio"
       },

package/skills/unicli/SKILL.md

@@ -11,7 +11,7 @@ description: >
   major platform; run desktop workflows or system tasks; or when the user says
   "unicli", "scrape", "fetch from", "get trending", "check [site]", "find on
   [platform]", "获取", "查询", "抓取".
-version: 0.222.0
+version: 0.222.1
 category: core
 depends-on:
   - talk-normal

package/skills/unicli-claude-code/SKILL.md

@@ -6,7 +6,7 @@ description: >
   newlines, or inline JSON — shell-quoted invocations hit TC0 circuit
   limits and drop to <50% success above ICS=4. Also covers --describe
   introspection and next_actions-driven navigation.
-version: 0.222.0
+version: 0.222.1
 depends-on:
   - talk-normal
 triggers:

package/skills/unicli-hermes/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Use Uni-CLI to interact with 237 websites, desktop apps, and system tools.
   Trigger when: user asks to check a website, fetch data, control a desktop app,
   or interact with social media, news, finance, or AI platforms.
-version: 0.222.0
+version: 0.222.1
 depends-on:
   - talk-normal
 triggers:

package/src/adapters/instagram/reels.yaml

@@ -13,13 +13,10 @@ args:
 
 pipeline:
   - fetch:
-      url: https://www.instagram.com/api/v1/clips/trending/
-      method: POST
-      body:
-        max_id: ""
-        page_size: "${{ args.limit }}"
+      url: https://www.instagram.com/api/v1/clips/discover/
       headers:
-        X-CSRFToken: "${{ cookies.csrftoken }}"
+        X-IG-App-ID: "936619743392459"
+        User-Agent: "Instagram 219.0.0.12.117 Android"
 
   - select: items
 
@@ -38,5 +35,6 @@ capabilities: ["http.fetch"]
 minimum_capability: http.fetch
 trust: public
 confidentiality: public
-quarantine: false
+quarantine: true
+quarantineReason: "2026-05-24: Instagram retired /api/v1/clips/trending/; /api/v1/clips/discover/ requires live authenticated browser validation before this web-api route can be trusted."
 schema_version: v2

package/src/adapters/weread/shelf.yaml

@@ -14,7 +14,7 @@ args:
 
 pipeline:
   - fetch:
-      url: https://weread.qq.com/web/shelf/sync
+      url: https://i.weread.qq.com/shelf/sync
       method: POST
       headers:
         Content-Type: application/json