@manifest-network/manifest-agent-core 0.9.0

package/dist/types.d.ts

@@ -0,0 +1,294 @@
+import { CosmosClientManager, WalletProvider } from "@manifest-network/manifest-mcp-core";
+
+//#region src/types.d.ts
+interface Coin {
+  denom: string;
+  amount: string;
+}
+interface FeeEstimate {
+  coins: Coin[];
+  gas: number;
+}
+interface DenomLookup {
+  symbol: string;
+  exponent: number;
+}
+interface DenomMap {
+  /** Look up a denom by string; returns `null` for unknown denoms. */
+  lookup(denom: string): DenomLookup | null;
+  /** Raw chain-registry JSON when loaded from `chainDataFile`; `null` for stub/empty maps. */
+  raw: unknown;
+}
+/**
+ * Shared runtime resources required by all four public agent-core
+ * functions. Build once per caller-session; spread into per-call options.
+ */
+interface AgentCoreRuntime {
+  /** Cosmos chain client (signing + querying). Callers bind their own wallet at construction. */
+  clientManager: CosmosClientManager;
+  /** Optional fetch implementation; defaults to `globalThis.fetch` inside fred's deployApp. */
+  fetchFn?: typeof globalThis.fetch;
+}
+/**
+ * Per-call options for `deployApp`. Extends `AgentCoreRuntime` with the
+ * deploy-only `walletProvider` (ADR-036 auth-token construction) plus
+ * the optional DenomMap injection (chain-registry-driven humanization).
+ */
+interface DeployAppOptions extends AgentCoreRuntime {
+  /**
+   * Wallet provider for ADR-036 auth-token signing.
+   *
+   * **MUST** implement `signArbitrary` — validated at the call boundary
+   * with `ManifestMCPError(INVALID_CONFIG)` thrown if absent. agent-core
+   * constructs the auth-token callbacks internally from this wallet
+   * (using fred's `createAuthToken` + `createSignMessage` +
+   * `createLeaseDataSignMessage` primitives + `AuthTimestampTracker`
+   * for monotonic replay-safe timestamps). Keeps the host-surface API
+   * clean (no ADR-036 plumbing required from callers).
+   *
+   * The `signArbitrary` return shape must match the cosmjs convention:
+   *
+   *   `{ pub_key: { type: string, value: string }, signature: string }`
+   *
+   * where `pub_key.value` is the base64-encoded public-key bytes and
+   * `signature` is the base64-encoded signature. Non-cosmjs
+   * `WalletProvider` implementations (e.g. one returning
+   * `pub_key.value` as `Uint8Array`) would silently miscompose the
+   * persisted token; we rely on the convention rather than a runtime
+   * guard today.
+   */
+  walletProvider: WalletProvider;
+  /** Path to a chain-registry JSON file (`{ feeTokens: [...] }`) for denom humanization. */
+  chainDataFile?: string;
+  /** Pre-loaded `DenomMap` (wins over `chainDataFile` when both supplied). */
+  denomMap?: DenomMap;
+  /**
+   * Optional directory for persisting the deployment manifest after a
+   * successful deploy. When provided, the orchestrator passes it to
+   * `saveManifest()` (`internals/save-manifest.ts`); see that function's
+   * `dataDir` JSDoc for the security-posture requirements (chmod-
+   * tightening implications — pass a dedicated subdirectory, NOT a
+   * shared parent like `$HOME`). When absent, persistence is skipped
+   * and the orchestrator still emits the success path per step-16's
+   * "save-fail still emits success" contract.
+   */
+  dataDir?: string;
+}
+/**
+ * Per-call options for `manageDomain` (PR 4). Doesn't broadcast through
+ * fred → no `walletProvider` required. Just the runtime base +
+ * humanization injection.
+ */
+interface ManageDomainOptions extends AgentCoreRuntime {
+  chainDataFile?: string;
+  denomMap?: DenomMap;
+}
+/**
+ * Per-call options for `closeLease` (PR 4). Doesn't broadcast through
+ * fred → no `walletProvider` required.
+ */
+interface CloseLeaseOptions extends AgentCoreRuntime {
+  chainDataFile?: string;
+  denomMap?: DenomMap;
+}
+/**
+ * Per-call options for `troubleshootDeployment` (PR 4). Doesn't
+ * broadcast through fred → no `walletProvider` required.
+ */
+interface TroubleshootOptions extends AgentCoreRuntime {
+  chainDataFile?: string;
+  denomMap?: DenomMap;
+}
+interface ServiceDef {
+  image: string;
+  ports?: number[];
+  env?: Record<string, string>;
+  args?: string[];
+  command?: string[];
+}
+interface SingleServiceSpec {
+  image: string;
+  port?: number | number[];
+  env?: Record<string, string>;
+  customDomain?: string;
+}
+interface StackSpec {
+  services: Record<string, ServiceDef>;
+  customDomain?: string;
+  serviceName?: string;
+}
+type DeploySpec = SingleServiceSpec | StackSpec;
+interface SpecSummary {
+  format: 'single' | 'stack';
+  serviceCount: number;
+  portCount: number;
+  envCount: number;
+  envKeys: string[];
+  images: string[];
+}
+type ReadinessAction = 'fund_credit' | 'request_faucet' | 'topup_wallet' | 'pick_different_sku';
+interface Readiness {
+  status: 'ok' | 'warn' | 'block';
+  reasons: string[];
+  suggestedActions: ReadinessAction[];
+  walletBalances: Coin[];
+  credits: {
+    availableBalances: Coin[];
+  } | null;
+  sku: {
+    name: string;
+    price: Coin;
+  } | null;
+}
+interface PlanFees {
+  createLease: FeeEstimate;
+  setDomain?: FeeEstimate | {
+    notEstimated: true;
+    reason: string;
+  };
+}
+interface Plan {
+  summary: SpecSummary;
+  readiness: Readiness;
+  fees: PlanFees;
+}
+type PlanEdit = {
+  kind: 'edit_env';
+  service?: string;
+  env: Record<string, string>;
+} | {
+  kind: 'replace_spec';
+  spec: DeploySpec;
+};
+interface DeploymentPlanBlock {
+  text: string;
+}
+type LeaseStateName = 'LEASE_STATE_UNSPECIFIED' | 'LEASE_STATE_PENDING' | 'LEASE_STATE_ACTIVE' | 'LEASE_STATE_INSUFFICIENT_FUNDS' | 'LEASE_STATE_CLOSED' | 'LEASE_STATE_REJECTED' | 'LEASE_STATE_EXPIRED';
+interface DeployResult {
+  leaseUuid: string;
+  providerUuid: string;
+  leaseState: LeaseStateName;
+  urls: string[];
+  customDomain?: string;
+  manifestPath: string;
+}
+type ProgressEvent = {
+  kind: 'readiness_evaluated';
+  readiness: Readiness;
+} | {
+  kind: 'deployment_plan_rendered';
+  block: DeploymentPlanBlock;
+} | {
+  kind: 'user_confirmed';
+} | {
+  kind: 'deploy_app_broadcast';
+  leaseUuid?: string;
+} | {
+  kind: 'deploy_response_classified';
+  outcome: 'active' | 'needs_wait' | 'failed';
+} | {
+  kind: 'app_ready_confirmed';
+  leaseUuid: string;
+} | {
+  kind: 'manifest_saved';
+  leaseUuid: string;
+  manifestPath: string;
+} | {
+  kind: 'success_rendered';
+  result: DeployResult;
+};
+type FailureEnvelope = {
+  outcome: 'partially_succeeded';
+  leaseUuid: string;
+  requestedCustomDomain?: string;
+  reason: string;
+} | {
+  outcome: 'failed';
+  reason: string;
+};
+type RecoveryOptionId = 'retry_set_domain' | 'salvage_without_domain' | 'cancel_lease' | 'close_lease';
+interface RecoveryOption {
+  id: RecoveryOptionId;
+  label: string;
+  description: string;
+}
+interface RecoveryChoice {
+  id: RecoveryOptionId;
+}
+interface DeployAppCallbacks {
+  onPlan?: (plan: Plan) => Promise<PlanEdit | 'confirm' | 'cancel'>;
+  onConfirm?: (block: DeploymentPlanBlock) => Promise<'yes' | 'no'>;
+  onProgress?: (event: ProgressEvent) => void;
+  onComplete?: (result: DeployResult) => void;
+  onFailure?: (failure: FailureEnvelope, options: RecoveryOption[]) => Promise<RecoveryChoice>;
+}
+type ManageDomainArgs = {
+  action: 'set';
+  leaseUuid: string;
+  fqdn: string;
+  serviceName?: string;
+} | {
+  action: 'clear';
+  leaseUuid: string;
+  serviceName?: string;
+} | {
+  action: 'lookup';
+  fqdn: string;
+};
+type ManageDomainResult = {
+  action: 'set';
+  leaseUuid: string;
+  verified: boolean;
+  finalCustomDomain: string | null;
+} | {
+  action: 'clear';
+  leaseUuid: string;
+  verified: boolean;
+  finalCustomDomain: string | null;
+} | {
+  action: 'lookup';
+  fqdn: string;
+  lease: {
+    leaseUuid: string;
+  } | null;
+};
+interface ManageDomainCallbacks {
+  onConfirm?: (block: DeploymentPlanBlock) => Promise<'yes' | 'no'>;
+  onProgress?: (event: ProgressEvent) => void;
+  onComplete?: (result: ManageDomainResult) => void;
+  onFailure?: (failure: {
+    reason: string;
+  }) => Promise<void>;
+}
+interface TroubleshootArgs {
+  leaseUuid: string;
+}
+interface TroubleshootReport {
+  markdown: string;
+}
+interface TroubleshootCallbacks {
+  onConfirm?: (block: DeploymentPlanBlock) => Promise<'yes' | 'no'>;
+  onProgress?: (event: ProgressEvent) => void;
+  onComplete?: (result: TroubleshootReport) => void;
+  onFailure?: (failure: {
+    reason: string;
+  }) => Promise<void>;
+}
+interface CloseLeaseArgs {
+  leaseUuid: string;
+}
+interface CloseLeaseResult {
+  leaseUuid: string;
+  finalState: LeaseStateName;
+}
+interface CloseLeaseCallbacks {
+  onConfirm?: (block: DeploymentPlanBlock) => Promise<'yes' | 'no'>;
+  onProgress?: (event: ProgressEvent) => void;
+  onComplete?: (result: CloseLeaseResult) => void;
+  onFailure?: (failure: {
+    reason: string;
+  }) => Promise<void>;
+}
+//#endregion
+export { AgentCoreRuntime, CloseLeaseArgs, CloseLeaseCallbacks, CloseLeaseOptions, CloseLeaseResult, Coin, type CosmosClientManager, DenomLookup, DenomMap, DeployAppCallbacks, DeployAppOptions, DeployResult, DeploySpec, DeploymentPlanBlock, FailureEnvelope, FeeEstimate, LeaseStateName, ManageDomainArgs, ManageDomainCallbacks, ManageDomainOptions, ManageDomainResult, Plan, PlanEdit, PlanFees, ProgressEvent, Readiness, ReadinessAction, RecoveryChoice, RecoveryOption, RecoveryOptionId, ServiceDef, SingleServiceSpec, SpecSummary, StackSpec, TroubleshootArgs, TroubleshootCallbacks, TroubleshootOptions, TroubleshootReport, type WalletProvider };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@manifest-network/manifest-agent-core",
+  "version": "0.9.0",
+  "description": "TypeScript orchestration surface for Manifest agent flows (deploy / manage-domain / troubleshoot / close-lease). Type contract only — see ENG-127.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "manifest",
+    "agent",
+    "orchestration",
+    "cosmos"
+  ],
+  "author": "Felix C. Morency",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/manifest-network/manifest-mcp-mono.git",
+    "directory": "packages/agent-core"
+  },
+  "homepage": "https://github.com/manifest-network/manifest-mcp-mono#readme",
+  "bugs": "https://github.com/manifest-network/manifest-mcp-mono/issues",
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@manifest-network/manifest-mcp-core": "^0.9.0",
+    "@manifest-network/manifest-mcp-fred": "^0.9.0",
+    "ipaddr.js": "2.4.0",
+    "undici": "8.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.15.29",
+    "typescript": "5.9.3",
+    "vitest": "4.1.0"
+  }
+}