@poncho-ai/cli 0.37.0 → 0.38.0

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   main
-} from "./chunk-GUGBKAIM.js";
+} from "./chunk-U643TWFX.js";
 
 // src/cli.ts
 void main();

package/dist/index.d.ts

@@ -1,139 +1,147 @@
-import { IncomingMessage, ServerResponse, Server } from 'node:http';
-import { AgentHarness, CronJobConfig, ConversationStore, Conversation } from '@poncho-ai/harness';
-import { AgentEvent, Message } from '@poncho-ai/sdk';
+import { Server, IncomingMessage, ServerResponse } from 'node:http';
+import * as _poncho_ai_harness from '@poncho-ai/harness';
+import { Conversation, ConversationStore, AgentHarness, PonchoConfig, CronJobConfig } from '@poncho-ai/harness';
+import { FileInput, AgentEvent, Message } from '@poncho-ai/sdk';
 import { MessagingAdapter } from '@poncho-ai/messaging';
 import { Command } from 'commander';
 
-type InitOnboardingOptions = {
-    yes?: boolean;
-    interactive?: boolean;
-};
-
+declare const writeJson: (response: ServerResponse, statusCode: number, payload: unknown) => void;
+declare const writeHtml: (response: ServerResponse, statusCode: number, payload: string) => void;
+declare const EXT_MIME_MAP: Record<string, string>;
+declare const extToMime: (ext: string) => string;
+declare const readRequestBody: (request: IncomingMessage) => Promise<unknown>;
+declare const parseTelegramMessageThreadIdFromPlatformThreadId: (platformThreadId: string | undefined, chatId: string | undefined) => number | undefined;
+declare const MAX_UPLOAD_SIZE: number;
+interface ParsedMultipart {
+    message: string;
+    parameters?: Record<string, unknown>;
+    files: FileInput[];
+}
+declare const parseMultipartRequest: (request: IncomingMessage) => Promise<ParsedMultipart>;
 /**
  * Detects the runtime environment from platform-specific or standard environment variables.
  * Priority: PONCHO_ENV > platform detection (Vercel, Railway, etc.) > NODE_ENV > "development"
  */
 declare const resolveHarnessEnvironment: () => "development" | "staging" | "production";
-type HistorySource = "harness" | "continuation" | "messages";
-type StoredApproval = NonNullable<Conversation["pendingApprovals"]>[number];
-type PendingToolCall = {
-    id: string;
-    name: string;
-    input: Record<string, unknown>;
-};
-type ApprovalEventItem = {
-    approvalId: string;
-    tool: string;
-    toolCallId?: string;
-    input: Record<string, unknown>;
-};
-type RunRequest = {
-    conversationId: string;
-    messages: Message[];
-    preferContinuation?: boolean;
-};
-type RunOutcome = {
-    source: HistorySource;
-    shouldRebuildCanonical: boolean;
-    messages: Message[];
-};
-type TurnSection = {
-    type: "text" | "tools";
-    content: string | string[];
-};
-type TurnDraftState = {
-    assistantResponse: string;
-    toolTimeline: string[];
-    sections: TurnSection[];
-    currentTools: string[];
-    currentText: string;
-};
-type ExecuteTurnResult = {
+declare const listenOnAvailablePort: (server: Server, preferredPort: number) => Promise<number>;
+declare const readJsonFile: <T>(path: string) => Promise<T | undefined>;
+declare const parseParams: (values: string[]) => Record<string, string>;
+declare const formatSseEvent: (event: AgentEvent) => string;
+
+declare const normalizeMessageForClient: (message: Message) => Message | null;
+type CronRunResult = {
+    response: string;
+    steps: number;
+    assistantMetadata?: Message["metadata"];
+    hasContent: boolean;
+    contextTokens: number;
+    contextWindow: number;
+    harnessMessages?: Message[];
+    toolResultArchive?: Conversation["_toolResultArchive"];
     latestRunId: string;
-    runCancelled: boolean;
-    runContinuation: boolean;
-    runContinuationMessages?: Message[];
-    runHarnessMessages?: Message[];
-    runContextTokens: number;
-    runContextWindow: number;
-    runSteps: number;
-    runMaxSteps?: number;
-    draft: TurnDraftState;
+    continuation: boolean;
+    continuationMessages?: Message[];
+    /** Stable id for the user-turn message persisted by buildCronMessages/appendCronTurn. */
+    userMessageId: string;
+    /** Timestamp shared by user and assistant messages of this turn. */
+    turnTimestamp: number;
 };
-declare const __internalRunOrchestration: {
-    isMessageArray: (value: unknown) => value is Message[];
-    loadCanonicalHistory: (conversation: Conversation) => {
-        messages: Message[];
-        source: HistorySource;
-    };
-    loadRunHistory: (conversation: Conversation, options?: {
-        preferContinuation?: boolean;
-    }) => {
-        messages: Message[];
-        source: HistorySource;
-        shouldRebuildCanonical: boolean;
-    };
-    normalizeApprovalCheckpoint: (approval: StoredApproval, fallbackMessages: Message[]) => StoredApproval;
-    buildApprovalCheckpoints: ({ approvals, runId, checkpointMessages, baseMessageCount, pendingToolCalls, }: {
-        approvals: ApprovalEventItem[];
-        runId: string;
-        checkpointMessages: Message[];
-        baseMessageCount: number;
-        pendingToolCalls: PendingToolCall[];
-    }) => NonNullable<Conversation["pendingApprovals"]>;
-    resolveRunRequest: (conversation: Conversation, request: RunRequest) => RunOutcome;
-    createTurnDraftState: () => TurnDraftState;
-    recordStandardTurnEvent: (draft: TurnDraftState, event: AgentEvent) => void;
-    executeConversationTurn: ({ harness, runInput, events, initialContextTokens, initialContextWindow, onEvent, }: {
-        harness: AgentHarness;
-        runInput?: Parameters<AgentHarness["runWithTelemetry"]>[0];
-        events?: AsyncIterable<AgentEvent>;
-        initialContextTokens?: number;
-        initialContextWindow?: number;
-        onEvent?: (event: AgentEvent, draft: TurnDraftState) => void | Promise<void>;
-    }) => Promise<ExecuteTurnResult>;
+declare const runCronAgent: (harnessRef: AgentHarness, task: string, conversationId: string, historyMessages: Message[], toolResultArchive?: Conversation["_toolResultArchive"], onEvent?: (event: AgentEvent) => void | Promise<void>) => Promise<CronRunResult>;
+declare const buildCronMessages: (task: string, historyMessages: Message[], result: CronRunResult) => Message[];
+/** Append a cron turn to a freshly-fetched conversation (avoids overwriting concurrent writes). */
+declare const appendCronTurn: (conv: Conversation, task: string, result: CronRunResult) => void;
+declare const MAX_PRUNE_PER_RUN = 25;
+/** Delete old cron conversations beyond `maxRuns`, capped to avoid API storms on catch-up. */
+declare const pruneCronConversations: (store: ConversationStore, ownerId: string, jobName: string, maxRuns: number) => Promise<number>;
+
+declare const AGENT_TEMPLATE: (name: string, id: string, options: {
+    modelProvider: "anthropic" | "openai" | "openai-codex";
+    modelName: string;
+}) => string;
+/**
+ * Resolve the monorepo packages root if we're running from a local dev build.
+ * Returns the absolute path to the \`packages/\` directory, or null when
+ * running from an npm-installed copy.
+ */
+declare const resolveLocalPackagesRoot: () => string | null;
+/**
+ * Resolve the @poncho-ai/cli dependency specifier for the scaffolded project.
+ * In dev mode we use \`link:\` so pnpm can resolve the local package;
+ * in production we point at the npm registry.
+ */
+declare const resolveCliDep: (projectDir: string) => Promise<string>;
+declare const PACKAGE_TEMPLATE: (name: string, projectDir: string) => Promise<string>;
+declare const README_TEMPLATE: (name: string) => string;
+declare const ENV_TEMPLATE = "ANTHROPIC_API_KEY=sk-ant-...\n";
+declare const GITIGNORE_TEMPLATE = ".env\nnode_modules\ndist\n.poncho/\ninteractive-session.json\n.vercel\n";
+declare const TEST_TEMPLATE = "tests:\n  - name: \"Basic sanity\"\n    task: \"What is 2 + 2?\"\n    expect:\n      contains: \"4\"\n";
+declare const SKILL_TEMPLATE = "---\nname: starter-skill\ndescription: Starter local skill template\nallowed-tools:\n  - ./scripts/starter-echo.ts\n---\n\n# Starter Skill\n\nThis is a starter local skill created by `poncho init`.\n\n## Authoring Notes\n\n- Put executable JavaScript/TypeScript files in `scripts/`.\n- Ask the agent to call `run_skill_script` with `skill`, `script`, and optional `input`.\n";
+declare const SKILL_TOOL_TEMPLATE = "export default async function run(input) {\n  const message = typeof input?.message === \"string\" ? input.message : \"\";\n  return { echoed: message };\n}\n";
+
+type DeployTarget = "none" | "vercel" | "docker" | "fly" | "lambda";
+type InitOnboardingOptions = {
+    yes?: boolean;
+    interactive?: boolean;
 };
+
+declare const packageRoot: string;
+declare const ensureFile: (path: string, content: string) => Promise<void>;
+type DeployScaffoldTarget = Exclude<DeployTarget, "none">;
+declare const normalizeDeployTarget: (target: string) => DeployScaffoldTarget;
+declare const readCliVersion: () => Promise<string>;
+declare const readCliDependencyVersion: (dependencyName: string, fallback: string) => Promise<string>;
+declare const writeScaffoldFile: (filePath: string, content: string, options: {
+    force?: boolean;
+    writtenPaths: string[];
+    baseDir: string;
+}) => Promise<void>;
+declare const UPLOAD_PROVIDER_DEPS: Record<string, Array<{
+    name: string;
+    fallback: string;
+}>>;
+declare const ensureRuntimeCliDependency: (projectDir: string, cliVersion: string, config?: PonchoConfig, target?: string) => Promise<{
+    paths: string[];
+    addedDeps: string[];
+}>;
+declare const checkVercelCronDrift: (projectDir: string) => Promise<void>;
+declare const scaffoldDeployTarget: (projectDir: string, target: DeployScaffoldTarget, options?: {
+    force?: boolean;
+}) => Promise<string[]>;
+declare const serializeJs: (value: unknown, indent?: number) => string;
+declare const renderConfigFile: (config: PonchoConfig) => string;
+declare const writeConfigFile: (workingDir: string, config: PonchoConfig) => Promise<void>;
+declare const ensureEnvPlaceholder: (filePath: string, key: string) => Promise<boolean>;
+declare const removeEnvPlaceholder: (filePath: string, key: string) => Promise<boolean>;
+
 declare const initProject: (projectName: string, options?: {
     workingDir?: string;
     onboarding?: InitOnboardingOptions;
     envExampleOverride?: string;
 }) => Promise<void>;
 declare const updateAgentGuidance: (workingDir: string) => Promise<boolean>;
-type RequestHandler = ((request: IncomingMessage, response: ServerResponse) => Promise<void>) & {
-    _harness?: AgentHarness;
-    _cronJobs?: Record<string, CronJobConfig>;
-    _conversationStore?: ConversationStore;
-    _messagingAdapters?: Map<string, MessagingAdapter>;
-    _activeConversationRuns?: Map<string, {
-        ownerId: string;
-        abortController: AbortController;
-        runId: string | null;
-    }>;
-    _pendingCallbackNeeded?: Set<string>;
-    _processSubagentCallback?: (conversationId: string, skipLockCheck?: boolean) => Promise<void>;
-    _broadcastEvent?: (conversationId: string, event: AgentEvent) => void;
-    _finishConversationStream?: (conversationId: string) => void;
-    _checkAndFireReminders?: () => Promise<{
-        fired: string[];
-        count: number;
-        duration: number;
-    }>;
-    _reminderPollIntervalMs?: number;
-};
-declare const createRequestHandler: (options?: {
-    workingDir?: string;
-}) => Promise<RequestHandler>;
-declare const startDevServer: (port: number, options?: {
-    workingDir?: string;
-}) => Promise<Server>;
-declare const runOnce: (task: string, options: {
-    params: Record<string, string>;
-    json: boolean;
-    filePaths: string[];
-    workingDir?: string;
-}) => Promise<void>;
-declare const runInteractive: (workingDir: string, params: Record<string, string>) => Promise<void>;
-declare const listTools: (workingDir: string) => Promise<void>;
+
+declare const runPnpmInstall: (workingDir: string) => Promise<void>;
+declare const runInstallCommand: (workingDir: string, packageNameOrPath: string) => Promise<void>;
+/**
+ * Resolve the installed npm package name from a package specifier.
+ * Handles local paths, scoped packages, and GitHub shorthand (e.g.
+ * "vercel-labs/agent-skills" installs as "agent-skills").
+ */
+declare const resolveInstalledPackageName: (packageNameOrPath: string) => string | null;
+/**
+ * Locate the root directory of an installed skill package.
+ * Handles local paths, normal npm packages, and GitHub repos (which may
+ * lack a root package.json).
+ */
+declare const resolveSkillRoot: (workingDir: string, packageNameOrPath: string) => string;
+declare const normalizeSkillSourceName: (value: string) => string;
+declare const collectSkillManifests: (dir: string, depth?: number) => Promise<string[]>;
+declare const validateSkillPackage: (workingDir: string, packageNameOrPath: string) => Promise<{
+    skillRoot: string;
+    manifests: string[];
+}>;
+declare const selectSkillManifests: (skillRoot: string, manifests: string[], relativeSkillPath?: string) => Promise<string[]>;
+declare const copySkillsIntoProject: (workingDir: string, manifests: string[], sourceName: string) => Promise<string[]>;
 declare const copySkillsFromPackage: (workingDir: string, packageNameOrPath: string, options?: {
     path?: string;
 }) => Promise<string[]>;
@@ -151,13 +159,12 @@ declare const removeSkillPackage: (workingDir: string, packageNameOrPath: string
 }) => Promise<void>;
 declare const listInstalledSkills: (workingDir: string, sourceName?: string) => Promise<string[]>;
 declare const listSkills: (workingDir: string, sourceName?: string) => Promise<void>;
-declare const runTests: (workingDir: string, filePath?: string) => Promise<{
-    passed: number;
-    failed: number;
-}>;
-declare const buildTarget: (workingDir: string, target: string, options?: {
-    force?: boolean;
-}) => Promise<void>;
+
+declare const normalizeMcpName: (entry: {
+    url?: string;
+    name?: string;
+}) => string;
+
 declare const mcpAdd: (workingDir: string, options: {
     url?: string;
     name?: string;
@@ -167,13 +174,64 @@ declare const mcpAdd: (workingDir: string, options: {
 }) => Promise<void>;
 declare const mcpList: (workingDir: string) => Promise<void>;
 declare const mcpRemove: (workingDir: string, name: string) => Promise<void>;
+declare const resolveMcpEntry: (workingDir: string, serverName: string) => Promise<{
+    config: _poncho_ai_harness.PonchoConfig;
+    index: number;
+}>;
+
+declare const discoverMcpTools: (workingDir: string, serverName: string) => Promise<string[]>;
+
 declare const mcpToolsList: (workingDir: string, serverName: string) => Promise<void>;
 declare const mcpToolsSelect: (workingDir: string, serverName: string, options: {
     all?: boolean;
     toolsCsv?: string;
 }) => Promise<void>;
+
+declare const runTests: (workingDir: string, filePath?: string) => Promise<{
+    passed: number;
+    failed: number;
+}>;
+declare const buildTarget: (workingDir: string, target: string, options?: {
+    force?: boolean;
+}) => Promise<void>;
+
+declare const runOnce: (task: string, options: {
+    params: Record<string, string>;
+    json: boolean;
+    filePaths: string[];
+    workingDir?: string;
+}) => Promise<void>;
+declare const runInteractive: (workingDir: string, params: Record<string, string>) => Promise<void>;
+declare const listTools: (workingDir: string) => Promise<void>;
+
+type RequestHandler = ((request: IncomingMessage, response: ServerResponse) => Promise<void>) & {
+    _harness?: AgentHarness;
+    _cronJobs?: Record<string, CronJobConfig>;
+    _conversationStore?: ConversationStore;
+    _messagingAdapters?: Map<string, MessagingAdapter>;
+    _activeConversationRuns?: Map<string, {
+        ownerId: string;
+        abortController: AbortController;
+        runId: string | null;
+    }>;
+    _pendingCallbackNeeded?: Set<string>;
+    _processSubagentCallback?: (conversationId: string, skipLockCheck?: boolean) => Promise<void>;
+    _broadcastEvent?: (conversationId: string, event: AgentEvent) => void;
+    _finishConversationStream?: (conversationId: string) => void;
+    _checkAndFireReminders?: () => Promise<{
+        fired: string[];
+        count: number;
+        duration: number;
+    }>;
+    _reminderPollIntervalMs?: number;
+};
+declare const createRequestHandler: (options?: {
+    workingDir?: string;
+}) => Promise<RequestHandler>;
+declare const startDevServer: (port: number, options?: {
+    workingDir?: string;
+}) => Promise<Server>;
 declare const buildCli: () => Command;
 declare const main: (argv?: string[]) => Promise<void>;
-declare const packageRoot: string;
 
-export { type RequestHandler, __internalRunOrchestration, addSkill, buildCli, buildTarget, copySkillsFromPackage, createRequestHandler, initProject, listInstalledSkills, listSkills, listTools, main, mcpAdd, mcpList, mcpRemove, mcpToolsList, mcpToolsSelect, packageRoot, removeSkillPackage, removeSkillsFromPackage, resolveHarnessEnvironment, runInteractive, runOnce, runTests, startDevServer, updateAgentGuidance };
+export { AGENT_TEMPLATE, type CronRunResult, ENV_TEMPLATE, EXT_MIME_MAP, GITIGNORE_TEMPLATE, MAX_PRUNE_PER_RUN, MAX_UPLOAD_SIZE, PACKAGE_TEMPLATE, type ParsedMultipart, README_TEMPLATE, type RequestHandler, SKILL_TEMPLATE, SKILL_TOOL_TEMPLATE, TEST_TEMPLATE, UPLOAD_PROVIDER_DEPS, addSkill, appendCronTurn, buildCli, buildCronMessages, buildTarget, checkVercelCronDrift, collectSkillManifests, copySkillsFromPackage, copySkillsIntoProject, createRequestHandler, discoverMcpTools, ensureEnvPlaceholder, ensureFile, ensureRuntimeCliDependency, extToMime, formatSseEvent, initProject, listInstalledSkills, listSkills, listTools, listenOnAvailablePort, main, mcpAdd, mcpList, mcpRemove, mcpToolsList, mcpToolsSelect, normalizeDeployTarget, normalizeMcpName, normalizeMessageForClient, normalizeSkillSourceName, packageRoot, parseMultipartRequest, parseParams, parseTelegramMessageThreadIdFromPlatformThreadId, pruneCronConversations, readCliDependencyVersion, readCliVersion, readJsonFile, readRequestBody, removeEnvPlaceholder, removeSkillPackage, removeSkillsFromPackage, renderConfigFile, resolveCliDep, resolveHarnessEnvironment, resolveInstalledPackageName, resolveLocalPackagesRoot, resolveMcpEntry, resolveSkillRoot, runCronAgent, runInstallCommand, runInteractive, runOnce, runPnpmInstall, runTests, scaffoldDeployTarget, selectSkillManifests, serializeJs, startDevServer, updateAgentGuidance, validateSkillPackage, writeConfigFile, writeHtml, writeJson, writeScaffoldFile };

package/dist/index.js

@@ -1,54 +1,160 @@
 import {
-  __internalRunOrchestration,
+  AGENT_TEMPLATE,
+  ENV_TEMPLATE,
+  EXT_MIME_MAP,
+  GITIGNORE_TEMPLATE,
+  MAX_PRUNE_PER_RUN,
+  MAX_UPLOAD_SIZE,
+  PACKAGE_TEMPLATE,
+  README_TEMPLATE,
+  SKILL_TEMPLATE,
+  SKILL_TOOL_TEMPLATE,
+  TEST_TEMPLATE,
+  UPLOAD_PROVIDER_DEPS,
   addSkill,
+  appendCronTurn,
   buildCli,
+  buildCronMessages,
   buildTarget,
+  checkVercelCronDrift,
+  collectSkillManifests,
   copySkillsFromPackage,
+  copySkillsIntoProject,
   createRequestHandler,
+  discoverMcpTools,
+  ensureEnvPlaceholder,
+  ensureFile,
+  ensureRuntimeCliDependency,
+  extToMime,
+  formatSseEvent,
   initProject,
   listInstalledSkills,
   listSkills,
   listTools,
+  listenOnAvailablePort,
   main,
   mcpAdd,
   mcpList,
   mcpRemove,
   mcpToolsList,
   mcpToolsSelect,
+  normalizeDeployTarget,
+  normalizeMcpName,
+  normalizeMessageForClient,
+  normalizeSkillSourceName,
   packageRoot,
+  parseMultipartRequest,
+  parseParams,
+  parseTelegramMessageThreadIdFromPlatformThreadId,
+  pruneCronConversations,
+  readCliDependencyVersion,
+  readCliVersion,
+  readJsonFile,
+  readRequestBody,
+  removeEnvPlaceholder,
   removeSkillPackage,
   removeSkillsFromPackage,
+  renderConfigFile,
+  resolveCliDep,
   resolveHarnessEnvironment,
+  resolveInstalledPackageName,
+  resolveLocalPackagesRoot,
+  resolveMcpEntry,
+  resolveSkillRoot,
+  runCronAgent,
+  runInstallCommand,
   runInteractive,
   runOnce,
+  runPnpmInstall,
   runTests,
+  scaffoldDeployTarget,
+  selectSkillManifests,
+  serializeJs,
   startDevServer,
-  updateAgentGuidance
-} from "./chunk-GUGBKAIM.js";
+  updateAgentGuidance,
+  validateSkillPackage,
+  writeConfigFile,
+  writeHtml,
+  writeJson,
+  writeScaffoldFile
+} from "./chunk-U643TWFX.js";
 export {
-  __internalRunOrchestration,
+  AGENT_TEMPLATE,
+  ENV_TEMPLATE,
+  EXT_MIME_MAP,
+  GITIGNORE_TEMPLATE,
+  MAX_PRUNE_PER_RUN,
+  MAX_UPLOAD_SIZE,
+  PACKAGE_TEMPLATE,
+  README_TEMPLATE,
+  SKILL_TEMPLATE,
+  SKILL_TOOL_TEMPLATE,
+  TEST_TEMPLATE,
+  UPLOAD_PROVIDER_DEPS,
   addSkill,
+  appendCronTurn,
   buildCli,
+  buildCronMessages,
   buildTarget,
+  checkVercelCronDrift,
+  collectSkillManifests,
   copySkillsFromPackage,
+  copySkillsIntoProject,
   createRequestHandler,
+  discoverMcpTools,
+  ensureEnvPlaceholder,
+  ensureFile,
+  ensureRuntimeCliDependency,
+  extToMime,
+  formatSseEvent,
   initProject,
   listInstalledSkills,
   listSkills,
   listTools,
+  listenOnAvailablePort,
   main,
   mcpAdd,
   mcpList,
   mcpRemove,
   mcpToolsList,
   mcpToolsSelect,
+  normalizeDeployTarget,
+  normalizeMcpName,
+  normalizeMessageForClient,
+  normalizeSkillSourceName,
   packageRoot,
+  parseMultipartRequest,
+  parseParams,
+  parseTelegramMessageThreadIdFromPlatformThreadId,
+  pruneCronConversations,
+  readCliDependencyVersion,
+  readCliVersion,
+  readJsonFile,
+  readRequestBody,
+  removeEnvPlaceholder,
   removeSkillPackage,
   removeSkillsFromPackage,
+  renderConfigFile,
+  resolveCliDep,
   resolveHarnessEnvironment,
+  resolveInstalledPackageName,
+  resolveLocalPackagesRoot,
+  resolveMcpEntry,
+  resolveSkillRoot,
+  runCronAgent,
+  runInstallCommand,
   runInteractive,
   runOnce,
+  runPnpmInstall,
   runTests,
+  scaffoldDeployTarget,
+  selectSkillManifests,
+  serializeJs,
   startDevServer,
-  updateAgentGuidance
+  updateAgentGuidance,
+  validateSkillPackage,
+  writeConfigFile,
+  writeHtml,
+  writeJson,
+  writeScaffoldFile
 };