@open-agent-toolkit/cli 0.2.51 → 0.2.52

package/dist/providers/shared/restart-adviser.d.ts

@@ -0,0 +1,26 @@
+import type { ProviderCatalogRefreshPolicy } from './registry.js';
+export interface ProviderRecoveryAction {
+    code: string;
+    command?: string;
+    message: string;
+}
+export type ProviderMaterializationState = 'not-required' | 'current' | 'planned' | 'changed' | 'missing' | 'failed' | 'unsupported' | 'unknown';
+export type ProviderVisibilityState = 'visible' | 'not-reported' | 'refresh-required' | 'restart-required' | 'unsupported' | 'unknown';
+export type ProviderVisibilityEvidenceSource = 'runtime-observation' | 'provider-refresh-policy' | 'materialization-result';
+export interface ProviderCatalogObservation {
+    state: 'visible' | 'not-reported';
+    reference: string;
+}
+export interface ProviderVisibilityEvidence {
+    state: ProviderVisibilityState;
+    source: ProviderVisibilityEvidenceSource;
+    reason: string;
+    policy: ProviderCatalogRefreshPolicy;
+    recovery: readonly ProviderRecoveryAction[];
+}
+export declare function adviseProviderRefresh(input: {
+    policy: ProviderCatalogRefreshPolicy;
+    materialization: ProviderMaterializationState;
+    observation?: ProviderCatalogObservation;
+}): ProviderVisibilityEvidence;
+//# sourceMappingURL=restart-adviser.d.ts.map

package/dist/providers/shared/restart-adviser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart-adviser.d.ts","sourceRoot":"","sources":["../../../src/providers/shared/restart-adviser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,4BAA4B,GACpC,cAAc,GACd,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,QAAQ,GACR,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,MAAM,uBAAuB,GAC/B,SAAS,GACT,cAAc,GACd,kBAAkB,GAClB,kBAAkB,GAClB,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,MAAM,gCAAgC,GACxC,qBAAqB,GACrB,yBAAyB,GACzB,wBAAwB,CAAC;AAE7B,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,SAAS,GAAG,cAAc,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,uBAAuB,CAAC;IAC/B,MAAM,EAAE,gCAAgC,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,4BAA4B,CAAC;IACrC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAC;CAC7C;AAiBD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,MAAM,EAAE,4BAA4B,CAAC;IACrC,eAAe,EAAE,4BAA4B,CAAC;IAC9C,WAAW,CAAC,EAAE,0BAA0B,CAAC;CAC1C,GAAG,0BAA0B,CAkG7B"}

package/dist/providers/shared/restart-adviser.js

@@ -0,0 +1,96 @@
+const MATERIALIZATION_REASONS = {
+    'not-required': 'No provider materialization is required',
+    current: 'Materialization is current, but the active provider catalog was not observed',
+    planned: 'Materialization is only planned; provider visibility cannot be observed yet',
+    missing: 'Provider materialization is missing',
+    failed: 'Provider materialization failed',
+    unsupported: 'Provider materialization is unsupported',
+    unknown: 'Provider materialization state is unknown',
+};
+export function adviseProviderRefresh(input) {
+    if (input.observation?.state === 'visible') {
+        return {
+            state: 'visible',
+            source: 'runtime-observation',
+            reason: input.observation.reference,
+            policy: input.policy,
+            recovery: [],
+        };
+    }
+    if (input.observation?.state === 'not-reported') {
+        return {
+            state: 'not-reported',
+            source: 'runtime-observation',
+            reason: input.observation.reference,
+            policy: input.policy,
+            recovery: [],
+        };
+    }
+    if (input.materialization !== 'changed') {
+        return {
+            state: input.materialization === 'unsupported' ? 'unsupported' : 'unknown',
+            source: 'materialization-result',
+            reason: MATERIALIZATION_REASONS[input.materialization],
+            policy: input.policy,
+            recovery: [],
+        };
+    }
+    if (input.policy.state === 'unknown') {
+        return {
+            state: 'unknown',
+            source: 'provider-refresh-policy',
+            reason: input.policy.reason,
+            policy: input.policy,
+            recovery: [],
+        };
+    }
+    if (input.policy.state === 'manual-refresh') {
+        return {
+            state: 'refresh-required',
+            source: 'provider-refresh-policy',
+            reason: `Provider refresh is required after a successful materialization change (${input.policy.provenance.reference})`,
+            policy: input.policy,
+            recovery: [
+                {
+                    code: 'refresh-provider-catalog',
+                    message: 'Refresh the provider catalog in the active session, then inspect it for the materialized asset.',
+                },
+            ],
+        };
+    }
+    if (input.policy.state === 'restart-required') {
+        if (input.policy.provenance.kind === 'repository-decision') {
+            return {
+                state: 'restart-required',
+                source: 'provider-refresh-policy',
+                reason: `OAT conservatively advises starting a new provider session after a successful materialization change so the provider has an opportunity to load the changed asset; this does not prove runtime visibility (${input.policy.provenance.reference})`,
+                policy: input.policy,
+                recovery: [
+                    {
+                        code: 'start-new-provider-session',
+                        message: 'Start a new provider session so it has an opportunity to load the changed asset, then inspect its catalog.',
+                    },
+                ],
+            };
+        }
+        return {
+            state: 'restart-required',
+            source: 'provider-refresh-policy',
+            reason: `Provider restart is required after a successful materialization change (${input.policy.provenance.reference})`,
+            policy: input.policy,
+            recovery: [
+                {
+                    code: 'restart-provider',
+                    message: 'Restart the provider session, then inspect its catalog for the materialized asset.',
+                },
+            ],
+        };
+    }
+    return {
+        state: 'unknown',
+        source: 'provider-refresh-policy',
+        reason: 'The provider contract says catalog changes are live, but this run did not observe the active provider catalog',
+        policy: input.policy,
+        recovery: [],
+    };
+}

package/dist/shared/types.d.ts

@@ -6,6 +6,10 @@ export type SyncStrategy = z.infer<typeof SyncStrategySchema>;
 export declare const ScopeSchema: z.ZodEnum<["project", "user", "all"]>;
 export type Scope = z.infer<typeof ScopeSchema>;
 export type ConcreteScope = Exclude<Scope, 'all'>;
+export interface CanonicalScanTarget {
+    contentType: ContentType;
+    canonicalDir: string;
+}
 export declare const SCOPE_CONTENT_TYPES: Record<Scope, ContentType[]>;
 export declare const USER_SCOPE_MANAGED_AGENT_FILES: readonly ['oat-phase-implementer.md', 'oat-reviewer.md'];
 //# sourceMappingURL=types.d.ts.map

package/dist/shared/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB,uCAAqC,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,kBAAkB,wCAAsC,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,WAAW,uCAAqC,CAAC;AAC9D,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAQlD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,CAI5D,CAAC;AAEF,eAAO,MAAM,8BAA8B,YACzC,0BAA0B,EAC1B,iBAAiB,CACT,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB,uCAAqC,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,kBAAkB,wCAAsC,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,WAAW,uCAAqC,CAAC;AAC9D,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAQD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,CAI5D,CAAC;AAEF,eAAO,MAAM,8BAA8B,YACzC,0BAA0B,EAC1B,iBAAiB,CACT,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-agent-toolkit/cli",
-  "version": "0.2.51",
+  "version": "0.2.52",
   "private": false,
   "description": "Open Agent Toolkit CLI",
   "homepage": "https://github.com/voxmedia/open-agent-toolkit/tree/main/packages/cli",
@@ -34,7 +34,7 @@
     "ora": "^9.0.0",
     "yaml": "2.8.2",
     "zod": "^3.25.76",
-    "@open-agent-toolkit/control-plane": "0.2.51"
+    "@open-agent-toolkit/control-plane": "0.2.52"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",