@agirails/sdk 4.4.9 → 4.6.0

package/dist/cli/agirails.d.ts

@@ -1,13 +1,97 @@
 /**
  * npx agirails — One Command Entry Point
  *
- * 60-second quickstart: ask 3 questions → generate {slug}.md → real Sentinel
+ * 60-second quickstart: ask 3 questions → generate {slug}.md → bootstrap a
+ * real testnet wallet (Smart Wallet + 1K test USDC) → run a real Sentinel
  * onboarding request on Base Sepolia → reflection. PRD-event-driven-provider-
  * listening §5.7 replaced the prior MockRuntime earning-loop simulation with
  * a live Level 1 request against the deployed Sentinel agent.
+ *
+ * FIX-2 (2026-06): the wizard previously wrote a `mock` config with a random
+ * address and immediately invoked `runTest({ network: 'testnet' })`. The
+ * downstream `resolvePrivateKey` returned `undefined` and ACTPClient crashed.
+ * The wizard now runs `runInit({ mode: 'testnet', wallet: 'auto' })` BEFORE
+ * `runTest` so the keystore + Smart Wallet exist and the first transaction
+ * has a real signer behind it.
+ *
  * Re-entrant: if identity already exists, skips onboarding and runs test.
  *
  * @module cli/agirails
  */
+import { Output, ExitCodeValue } from './utils/output';
+/**
+ * Wizard answers — populated either by interactive prompts or supplied
+ * directly by callers (tests, automation).
+ */
+export interface WizardAnswers {
+    name: string;
+    service: string;
+    price: number;
+}
+/**
+ * Injection seams so tests can drive the wizard without spawning interactive
+ * subprocesses. Production code provides the real defaults — see
+ * `defaultWizardDeps()`.
+ */
+export interface WizardDeps {
+    /** Collect the 3 wizard answers (name / service / price). */
+    collectAnswers: (output: Output) => Promise<WizardAnswers | null>;
+    /** Resolve / prompt for the ACTP_KEY_PASSWORD before runInit. */
+    ensurePassword: (output: Output) => Promise<string | null>;
+    /** Run keystore + Smart Wallet bootstrap (defaults to commands/init.runInit). */
+    runInit: (opts: Record<string, unknown>, output: Output) => Promise<void>;
+    /** Run the Sentinel test transaction (defaults to commands/test.runTest). */
+    runTest: (output: Output) => Promise<void>;
+    /** Predicate — does the project already have a usable keystore? */
+    hasKeystore: (projectRoot: string) => boolean;
+    /** Is stdin a TTY right now? Exposed so tests can flip CI / interactive paths. */
+    isTTY: () => boolean;
+}
+/**
+ * Production wiring for the wizard. Tests substitute individual fields.
+ */
+export declare function defaultWizardDeps(): WizardDeps;
+/**
+ * A keystore is "present" when `.actp/keystore.json` exists OR the user
+ * has provided `ACTP_KEYSTORE_BASE64` / `ACTP_PRIVATE_KEY` env vars. Any
+ * of those satisfies `resolvePrivateKey()` in `runTest`.
+ */
+export declare function hasKeystoreDefault(projectRoot?: string): boolean;
+/**
+ * Build the V4 frontmatter + body for a fresh {slug}.md from wizard answers.
+ *
+ * Extracted so tests can verify the structure without going through the
+ * full wizard flow.
+ */
+export declare function buildIdentityFile(answers: WizardAnswers): {
+    filename: string;
+    content: string;
+    slug: string;
+};
+/**
+ * Orchestrate the wizard. Pure-ish: every side effect goes through `deps`,
+ * so the test suite can verify behavior without ever touching the network,
+ * the keystore encrypt path, or a real Sentinel deployment.
+ *
+ * Returns the exit code instead of calling process.exit so callers (and
+ * tests) can decide what to do with failures.
+ */
+export declare function runWizard(output: Output, deps?: WizardDeps): Promise<ExitCodeValue>;
+/**
+ * Map a runTest error to a structured output + the right exit code.
+ * Mirrors the existing setup-hint heuristic so users with no wallet / no
+ * funds / missing Sentinel address still get actionable next-step guidance.
+ */
+declare function handleTestError(error: unknown, output: Output): ExitCodeValue;
+declare function extractMessage(error: unknown): string;
+/** Heuristic — match the four most common runRequest / resolveAgent first-run
+ *  failure-message shapes so the setup hint only fires when actionable. */
+declare function looksLikeRunTestSetupError(message: string): boolean;
+export declare const __test: {
+    looksLikeRunTestSetupError: typeof looksLikeRunTestSetupError;
+    handleTestError: typeof handleTestError;
+    extractMessage: typeof extractMessage;
+    bootstrapMockConfig: (filename: string) => void;
+};
 export {};
 //# sourceMappingURL=agirails.d.ts.map

package/dist/cli/agirails.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agirails.d.ts","sourceRoot":"","sources":["../../src/cli/agirails.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}
+{"version":3,"file":"agirails.d.ts","sourceRoot":"","sources":["../../src/cli/agirails.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,EAAE,MAAM,EAAiB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAqCtE;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAClE,iEAAiE;IACjE,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3D,iFAAiF;IACjF,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,6EAA6E;IAC7E,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,mEAAmE;IACnE,WAAW,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,kFAAkF;IAClF,KAAK,EAAE,MAAM,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAwB9C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAS/E;AA4FD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAuC7G;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,UAAgC,GAAG,OAAO,CAAC,aAAa,CAAC,CAgK9G;AAED;;;;GAIG;AACH,iBAAS,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAOtE;AAED,iBAAS,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ9C;AAyDD;2EAC2E;AAC3E,iBAAS,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAW5D;AAGD,eAAO,MAAM,MAAM;;;;oCAOe,MAAM,KAAG,IAAI;CAU9C,CAAC"}