@dungle-scrubs/tallow 0.8.0

package/dist/sdk.d.ts

@@ -0,0 +1,112 @@
+import { type CreateAgentSessionOptions, type CreateAgentSessionResult, type ExtensionFactory, type PromptTemplate, type Skill } from "@mariozechner/pi-coding-agent";
+import { type ResolvedPlugin } from "./plugins.js";
+export interface TallowSessionOptions {
+    /** Working directory. Default: process.cwd() */
+    cwd?: string;
+    /** Pre-resolved Model object. Takes precedence over provider/modelId strings. */
+    model?: CreateAgentSessionOptions["model"];
+    /** Provider name (e.g., "anthropic"). Used with modelId for string-based resolution. */
+    provider?: string;
+    /** Model ID (e.g., "claude-sonnet-4"). Used with provider for string-based resolution. */
+    modelId?: string;
+    /** Runtime API key override (not persisted to auth.json). Requires provider to be set. */
+    apiKey?: string;
+    /** Thinking level. Default: from settings or "off" */
+    thinkingLevel?: CreateAgentSessionOptions["thinkingLevel"];
+    /** Session management strategy */
+    session?: {
+        type: "memory";
+    } | {
+        type: "new";
+    } | {
+        type: "continue";
+    } | {
+        type: "open";
+        path: string;
+    } | {
+        type: "open-or-create";
+        sessionId: string;
+    } | {
+        type: "resume";
+        sessionId: string;
+    } | {
+        type: "fork";
+        sourceSessionId: string;
+    };
+    /** Additional extension paths (on top of bundled + user) */
+    additionalExtensions?: string[];
+    /** Plugin specs — remote repos or local paths (Claude Code or tallow format) */
+    plugins?: string[];
+    /** Additional extension factories (inline extensions) */
+    extensionFactories?: ExtensionFactory[];
+    /** Additional skills (on top of bundled + user) */
+    additionalSkills?: Skill[];
+    /** Additional prompt templates */
+    additionalPrompts?: PromptTemplate[];
+    /** Override the system prompt entirely */
+    systemPrompt?: string;
+    /** Append to the system prompt */
+    appendSystemPrompt?: string;
+    /** Disable bundled extensions */
+    noBundledExtensions?: boolean;
+    /** Disable bundled skills */
+    noBundledSkills?: boolean;
+    /** Custom tools (in addition to built-in coding tools) */
+    customTools?: CreateAgentSessionOptions["customTools"];
+    /** Override built-in tools */
+    tools?: CreateAgentSessionOptions["tools"];
+    /** Settings overrides */
+    settings?: Record<string, unknown>;
+}
+type ToolArray = NonNullable<CreateAgentSessionOptions["tools"]>;
+/**
+ * Parse a comma-separated tool names string into an array of tool objects.
+ *
+ * Accepts individual tool names (read, bash, edit, write, grep, find, ls)
+ * and preset aliases (readonly, coding, none).
+ *
+ * @param toolString - Comma-separated tool names (e.g. "read,grep,find")
+ * @returns Array of resolved tool objects
+ * @throws Error with list of valid names when an unknown tool is specified
+ */
+export declare function parseToolFlag(toolString: string): ToolArray;
+export interface TallowSession {
+    /** The underlying AgentSession */
+    session: CreateAgentSessionResult["session"];
+    /** Extension loading results */
+    extensions: CreateAgentSessionResult["extensionsResult"];
+    /** Model fallback message (if session model couldn't be restored) */
+    modelFallbackMessage?: string;
+    /** Tallow version */
+    version: string;
+    /** Bundled extensions overridden by user extensions (name → user path) */
+    extensionOverrides: Array<{
+        name: string;
+        userPath: string;
+    }>;
+    /** Resolved plugins (remote + local) */
+    resolvedPlugins: ResolvedPlugin[];
+    /** Session ID (UUID or user-provided) for programmatic chaining */
+    sessionId: string;
+}
+/**
+ * Create a Tallow session with all bundled extensions, skills, prompts,
+ * and agents pre-loaded. This is the main SDK entry point.
+ *
+ * ```typescript
+ * import { createTallowSession } from "tallow";
+ *
+ * const { session } = await createTallowSession();
+ *
+ * session.subscribe((event) => {
+ *   if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
+ *     process.stdout.write(event.assistantMessageEvent.delta);
+ *   }
+ * });
+ *
+ * await session.prompt("Fix the failing tests");
+ * ```
+ */
+export declare function createTallowSession(options?: TallowSessionOptions): Promise<TallowSession>;
+export {};
+//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

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