@openadapter/koda 1.0.0-beta.10

package/dist/config.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Detect if we're running as a Bun compiled binary.
+ * Bun binaries have import.meta.url containing "$bunfs", "~BUN", or "%7EBUN" (Bun's virtual filesystem path)
+ */
+export declare const isBunBinary: boolean;
+/** Detect if Bun is the runtime (compiled binary or bun run) */
+export declare const isBunRuntime: boolean;
+export type InstallMethod = "bun-binary" | "npm" | "pnpm" | "yarn" | "bun" | "unknown";
+interface SelfUpdateCommandStep {
+    command: string;
+    args: string[];
+    display: string;
+}
+export interface SelfUpdateCommand extends SelfUpdateCommandStep {
+    steps?: SelfUpdateCommandStep[];
+}
+export declare function detectInstallMethod(): InstallMethod;
+export declare function getSelfUpdateCommand(packageName: string, npmCommand?: string[], updatePackageName?: string): SelfUpdateCommand | undefined;
+export declare function getSelfUpdateUnavailableInstruction(packageName: string, npmCommand?: string[], updatePackageName?: string): string;
+export declare function getUpdateInstruction(packageName: string): string;
+/**
+ * Get the base directory for resolving package assets (themes, package.json, README.md, CHANGELOG.md).
+ * - For Bun binary: returns the directory containing the executable
+ * - For Node.js (dist/): returns __dirname (the dist/ directory)
+ * - For tsx (src/): returns parent directory (the package root)
+ */
+export declare function getPackageDir(): string;
+/**
+ * Get path to built-in themes directory (shipped with package)
+ * - For Bun binary: theme/ next to executable
+ * - For Node.js (dist/): dist/modes/interactive/theme/
+ * - For tsx (src/): src/modes/interactive/theme/
+ */
+export declare function getThemesDir(): string;
+/**
+ * Get path to HTML export template directory (shipped with package)
+ * - For Bun binary: export-html/ next to executable
+ * - For Node.js (dist/): dist/core/export-html/
+ * - For tsx (src/): src/core/export-html/
+ */
+export declare function getExportTemplateDir(): string;
+/** Get path to package.json */
+export declare function getPackageJsonPath(): string;
+/** Get path to README.md */
+export declare function getReadmePath(): string;
+/** Get path to docs directory */
+export declare function getDocsPath(): string;
+/** Get path to examples directory */
+export declare function getExamplesPath(): string;
+/** Get path to CHANGELOG.md */
+export declare function getChangelogPath(): string;
+/**
+ * Get path to built-in interactive assets directory.
+ * - For Bun binary: assets/ next to executable
+ * - For Node.js (dist/): dist/modes/interactive/assets/
+ * - For tsx (src/): src/modes/interactive/assets/
+ */
+export declare function getInteractiveAssetsDir(): string;
+/** Get path to a bundled interactive asset */
+export declare function getBundledInteractiveAssetPath(name: string): string;
+export declare const PACKAGE_NAME: string;
+export declare const APP_NAME: string;
+export declare const APP_TITLE: string;
+export declare const CONFIG_DIR_NAME: string;
+export declare const KODA_VERSION = "3";
+export declare const VERSION: string;
+export declare const ENV_AGENT_DIR: string;
+export declare const ENV_SESSION_DIR: string;
+export declare function expandTildePath(path: string): string;
+/** Get the share viewer URL for a gist ID */
+export declare function getShareViewerUrl(gistId: string): string;
+/** Get the agent config directory (e.g., ~/.pi/agent/) */
+export declare function getAgentDir(): string;
+/** Get path to user's custom themes directory */
+export declare function getCustomThemesDir(): string;
+/** Get path to models.json */
+export declare function getModelsPath(): string;
+/** Get path to auth.json */
+export declare function getAuthPath(): string;
+/** Get path to settings.json */
+export declare function getSettingsPath(): string;
+/** Get path to tools directory */
+export declare function getToolsDir(): string;
+/** Get path to managed binaries directory (fd, rg) */
+export declare function getBinDir(): string;
+/** Get path to prompt templates directory */
+export declare function getPromptsDir(): string;
+/** Get path to sessions directory */
+export declare function getSessionsDir(): string;
+/** Get path to debug log file */
+export declare function getDebugLogPath(): string;
+export {};

package/dist/config.js

@@ -0,0 +1 @@
+var j=Object.defineProperty;var r=(e,n)=>j(e,"name",{value:n,configurable:!0});import{accessSync as I,constants as U,existsSync as g,readFileSync as L,realpathSync as N}from"fs";import{homedir as A}from"os";import{basename as W,dirname as a,join as s,resolve as h,sep as $,win32 as K}from"path";import{fileURLToPath as V}from"url";import{spawnProcessSync as F}from"./utils/child-process.js";import{normalizePath as v}from"./utils/paths.js";const q=V(import.meta.url),P=a(q),b=import.meta.url.includes("$bunfs")||import.meta.url.includes("~BUN")||import.meta.url.includes("%7EBUN"),H=!!process.versions.bun;function y(e,n){return n?{...e,display:`${n.display} && ${e.display}`,steps:[n,e]}:e}r(y,"makeSelfUpdateCommand");function l(e,n){return{command:e,args:n,display:[e,...n].map(o=>/\s/.test(o)?`"${o}"`:o).join(" ")}}r(l,"makeSelfUpdateCommandStep");function S(){if(b)return"bun-binary";const e=`${P}\0${process.execPath||""}`.toLowerCase().replace(/\\/g,"/");return e.includes("/pnpm/")||e.includes("/.pnpm/")?"pnpm":e.includes("/yarn/")||e.includes("/.yarn/")?"yarn":H||e.includes("/install/global/node_modules/")?"bun":e.includes("/npm/")||e.includes("/node_modules/")?"npm":"unknown"}r(S,"detectInstallMethod");function C(){const e=u(),n=process.platform==="win32"||e.includes("\\")?K:{basename:W,dirname:a},o=n.dirname(e);let t;if(n.basename(o).startsWith("@")&&n.basename(n.dirname(o))==="node_modules"?t=n.dirname(o):n.basename(o)==="node_modules"&&(t=o),!t)return;const i=n.dirname(t);if(n.basename(i)==="lib")return{root:t,prefix:n.dirname(i)}}r(C,"getInferredNpmInstall");function O(e){return e.replace(/@[^@/]+$/,"")}r(O,"stripDistTag");function w(e,n,o=n,t){const i=O(o)===O(n);switch(e){case"bun-binary":return;case"pnpm":return y(l("pnpm",["install","-g","--ignore-scripts","--config.minimumReleaseAge=0",o]),i?void 0:l("pnpm",["remove","-g",n]));case"yarn":return y(l("yarn",["global","add","--ignore-scripts",o]),i?void 0:l("yarn",["global","remove",n]));case"bun":return y(l("bun",["install","-g","--ignore-scripts","--minimum-release-age=0",o]),i?void 0:l("bun",["uninstall","-g",n]));case"npm":{const[c="npm",...f]=t??[],m=t?.length?void 0:C(),p=[...f,...m?["--prefix",m.prefix]:[]],_=l(c,[...p,"install","-g","--ignore-scripts","--min-release-age=0",o]),M=i?void 0:l(c,[...p,"uninstall","-g",n]);return y(_,M)}case"unknown":return}}r(w,"getSelfUpdateCommandForMethod");function x(e,n,o={}){const t=F(e,n,{encoding:"utf-8",stdio:["ignore","pipe","pipe"]});if(t.status===0)return t.stdout.trim()||void 0;if(o.requireSuccess){const i=t.error?.message||t.stderr.trim()||`exit code ${t.status??"unknown"}`;throw new Error(`Failed to run ${[e,...n].join(" ")}: ${i}`)}}r(x,"readCommandOutput");function J(e,n,o){switch(e){case"npm":{const t=!!o?.length,[i="npm",...c]=o??[];if(t&&i==="bun"){const p=x(i,[...c,"pm","bin","-g"],{requireSuccess:!0}),_=[s(A(),".bun","install","global","node_modules")];return p&&_.push(s(a(p),"install","global","node_modules")),_}const f=x(i,[...c,"root","-g"],{requireSuccess:t}),m=t?void 0:C();return[f,m?.root].filter(p=>!!p)}case"pnpm":{const t=x("pnpm",["root","-g"]);return t?[t,a(t)]:[]}case"yarn":{const t=x("yarn",["global","dir"]);return t?[t,s(t,"node_modules")]:[]}case"bun":{const t=x("bun",["pm","bin","-g"]),i=[s(A(),".bun","install","global","node_modules")];return t&&i.push(s(a(t),"install","global","node_modules")),i}case"bun-binary":case"unknown":return[]}}r(J,"getGlobalPackageRoots");function R(e,n){const o=h(e);if(!g(o))return;let t=o;if(n)try{t=N(o)}catch{return}return process.platform==="win32"&&(t=t.toLowerCase()),t}r(R,"normalizeExistingPathForComparison");function T(e){return Array.from(new Set([R(e,!1),R(e,!0)].filter(n=>!!n)))}r(T,"getPathComparisonCandidates");function z(){const e=process.argv[1];if(!e)return;let n=a(e);for(;n!==a(n);){if(g(s(n,"package.json")))return n;n=a(n)}}r(z,"getEntrypointPackageDir");function k(){const e=u();try{return I(e,U.W_OK),I(a(e),U.W_OK),!0}catch{return!1}}r(k,"isSelfUpdatePathWritable");function G(e,n,o){const i=[u(),z()].filter(c=>!!c).flatMap(c=>T(c));return J(e,n,o).some(c=>T(c).some(f=>{const m=f.endsWith($)?f:`${f}${$}`;return i.some(p=>p.startsWith(m))}))}r(G,"isManagedByGlobalPackageManager");function pe(e,n,o=e){const t=S(),i=w(t,e,o,n);if(!(!i||!G(t,e,n)||!k()))return i}r(pe,"getSelfUpdateCommand");function Q(e,n,o=e){const t=S();if(t==="bun-binary")return"Download from: https://openadapter.in/releases/latest";const i=w(t,e,o,n);return i?G(t,e,n)&&!k()?`This installation is managed by a global ${t} install, but the install path is not writable. Update it yourself with: ${i.display}`:`This installation is not managed by a global ${t} install. Update it with the package manager, wrapper, or source checkout that provides it.`:`Update ${o} using the package manager, wrapper, or source checkout that provides this installation.`}r(Q,"getSelfUpdateUnavailableInstruction");function de(e){const n=S(),o=w(n,e);return o?`Run: ${o.display}`:Q(e)}r(de,"getUpdateInstruction");function u(){const e=process.env.KODA_PACKAGE_DIR;if(e)return v(e);if(b)return a(process.execPath);let n=P;for(;n!==a(n);){if(g(s(n,"package.json")))return n;n=a(n)}return P}r(u,"getPackageDir");function le(){if(b)return s(u(),"theme");const e=u(),n=g(s(e,"src"))?"src":"dist";return s(e,n,"modes","interactive","theme")}r(le,"getThemesDir");function fe(){if(b)return s(u(),"export-html");const e=u(),n=g(s(e,"src"))?"src":"dist";return s(e,n,"core","export-html")}r(fe,"getExportTemplateDir");function X(){return s(u(),"package.json")}r(X,"getPackageJsonPath");function me(){return h(s(u(),"README.md"))}r(me,"getReadmePath");function ge(){return h(s(u(),"docs"))}r(ge,"getDocsPath");function he(){return h(s(u(),"examples"))}r(he,"getExamplesPath");function be(){return h(s(u(),"CHANGELOG.md"))}r(be,"getChangelogPath");function Y(){if(b)return s(u(),"assets");const e=u(),n=g(s(e,"src"))?"src":"dist";return s(e,n,"modes","interactive","assets")}r(Y,"getInteractiveAssetsDir");function xe(e){return s(Y(),e)}r(xe,"getBundledInteractiveAssetPath");let D={};try{D=JSON.parse(L(X(),"utf-8"))}catch(e){if(e.code!=="ENOENT")throw e}const B=D.piConfig?.name,De=D.name||"@openadapter/koda",E=B||"pi",_e=B?E:"\u03C0",Z=D.piConfig?.configDir||".pi",ye="3",Ee=D.version||"0.0.0",ee=`${E.toUpperCase()}_CODING_AGENT_DIR`,Ae=`${E.toUpperCase()}_CODING_AGENT_SESSION_DIR`;function ne(e){return v(e)}r(ne,"expandTildePath");const te="https://openadapter.in/session/";function Pe(e){return`${process.env.KODA_SHARE_VIEWER_URL||te}#${e}`}r(Pe,"getShareViewerUrl");function d(){const e=process.env[ee];return e?ne(e):s(A(),Z,"agent")}r(d,"getAgentDir");function Se(){return s(d(),"themes")}r(Se,"getCustomThemesDir");function we(){return s(d(),"models.json")}r(we,"getModelsPath");function Ie(){return s(d(),"auth.json")}r(Ie,"getAuthPath");function Ue(){return s(d(),"settings.json")}r(Ue,"getSettingsPath");function $e(){return s(d(),"tools")}r($e,"getToolsDir");function ve(){return s(d(),"bin")}r(ve,"getBinDir");function Ce(){return s(d(),"prompts")}r(Ce,"getPromptsDir");function Oe(){return s(d(),"sessions")}r(Oe,"getSessionsDir");function Re(){return s(d(),`${E}-debug.log`)}r(Re,"getDebugLogPath");export{E as APP_NAME,_e as APP_TITLE,Z as CONFIG_DIR_NAME,ee as ENV_AGENT_DIR,Ae as ENV_SESSION_DIR,ye as KODA_VERSION,De as PACKAGE_NAME,Ee as VERSION,S as detectInstallMethod,ne as expandTildePath,d as getAgentDir,Ie as getAuthPath,ve as getBinDir,xe as getBundledInteractiveAssetPath,be as getChangelogPath,Se as getCustomThemesDir,Re as getDebugLogPath,ge as getDocsPath,he as getExamplesPath,fe as getExportTemplateDir,Y as getInteractiveAssetsDir,we as getModelsPath,u as getPackageDir,X as getPackageJsonPath,Ce as getPromptsDir,me as getReadmePath,pe as getSelfUpdateCommand,Q as getSelfUpdateUnavailableInstruction,Oe as getSessionsDir,Ue as getSettingsPath,Pe as getShareViewerUrl,le as getThemesDir,$e as getToolsDir,de as getUpdateInstruction,b as isBunBinary,H as isBunRuntime};

package/dist/core/agent-session-runtime.d.ts

@@ -0,0 +1,116 @@
+import type { AgentSession } from "./agent-session.ts";
+import type { AgentSessionRuntimeDiagnostic, AgentSessionServices } from "./agent-session-services.ts";
+import type { ReplacedSessionContext, SessionStartEvent } from "./extensions/index.ts";
+import type { CreateAgentSessionResult } from "./sdk.ts";
+import { SessionManager } from "./session-manager.ts";
+/**
+ * Result returned by runtime creation.
+ *
+ * The caller gets the created session, its cwd-bound services, and all
+ * diagnostics collected during setup.
+ */
+export interface CreateAgentSessionRuntimeResult extends CreateAgentSessionResult {
+    services: AgentSessionServices;
+    diagnostics: AgentSessionRuntimeDiagnostic[];
+}
+/**
+ * Creates a full runtime for a target cwd and session manager.
+ *
+ * The factory closes over process-global fixed inputs, recreates cwd-bound
+ * services for the effective cwd, resolves session options against those
+ * services, and finally creates the AgentSession.
+ */
+export type CreateAgentSessionRuntimeFactory = (options: {
+    cwd: string;
+    agentDir: string;
+    sessionManager: SessionManager;
+    sessionStartEvent?: SessionStartEvent;
+}) => Promise<CreateAgentSessionRuntimeResult>;
+/**
+ * Thrown when /import references a JSONL file path that does not exist.
+ */
+export declare class SessionImportFileNotFoundError extends Error {
+    readonly filePath: string;
+    constructor(filePath: string);
+}
+/**
+ * Owns the current AgentSession plus its cwd-bound services.
+ *
+ * Session replacement methods tear down the current runtime first, then create
+ * and apply the next runtime. If creation fails, the error is propagated to the
+ * caller. The caller is responsible for user-facing error handling.
+ */
+export declare class AgentSessionRuntime {
+    private rebindSession?;
+    private beforeSessionInvalidate?;
+    private _session;
+    private _services;
+    private readonly createRuntime;
+    private _diagnostics;
+    private _modelFallbackMessage?;
+    constructor(_session: AgentSession, _services: AgentSessionServices, createRuntime: CreateAgentSessionRuntimeFactory, _diagnostics?: AgentSessionRuntimeDiagnostic[], _modelFallbackMessage?: string);
+    get services(): AgentSessionServices;
+    get session(): AgentSession;
+    get cwd(): string;
+    get diagnostics(): readonly AgentSessionRuntimeDiagnostic[];
+    get modelFallbackMessage(): string | undefined;
+    setRebindSession(rebindSession?: (session: AgentSession) => Promise<void>): void;
+    /**
+     * Set a synchronous callback that runs after `session_shutdown` handlers finish
+     * but before the current session is invalidated.
+     *
+     * This is for host-owned UI teardown that must not yield to the event loop,
+     * such as detaching extension-provided TUI components before the old extension
+     * context becomes stale.
+     */
+    setBeforeSessionInvalidate(beforeSessionInvalidate?: () => void): void;
+    private emitBeforeSwitch;
+    private emitBeforeFork;
+    private teardownCurrent;
+    private apply;
+    private finishSessionReplacement;
+    switchSession(sessionPath: string, options?: {
+        cwdOverride?: string;
+        withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
+    }): Promise<{
+        cancelled: boolean;
+    }>;
+    newSession(options?: {
+        parentSession?: string;
+        setup?: (sessionManager: SessionManager) => Promise<void>;
+        withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
+    }): Promise<{
+        cancelled: boolean;
+    }>;
+    fork(entryId: string, options?: {
+        position?: "before" | "at";
+        withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
+    }): Promise<{
+        cancelled: boolean;
+        selectedText?: string;
+    }>;
+    /**
+     * Import a session JSONL file and switch runtime state to the imported session.
+     *
+     * @returns `{ cancelled: true }` when cancelled by `session_before_switch`, otherwise `{ cancelled: false }`.
+     * @throws {SessionImportFileNotFoundError} When the input path does not exist.
+     * @throws {MissingSessionCwdError} When the imported session cwd cannot be resolved and no override is provided.
+     */
+    importFromJsonl(inputPath: string, cwdOverride?: string): Promise<{
+        cancelled: boolean;
+    }>;
+    dispose(): Promise<void>;
+}
+/**
+ * Create the initial runtime from a runtime factory and initial session target.
+ *
+ * The same factory is stored on the returned AgentSessionRuntime and reused for
+ * later /new, /resume, /fork, and import flows.
+ */
+export declare function createAgentSessionRuntime(createRuntime: CreateAgentSessionRuntimeFactory, options: {
+    cwd: string;
+    agentDir: string;
+    sessionManager: SessionManager;
+    sessionStartEvent?: SessionStartEvent;
+}): Promise<AgentSessionRuntime>;
+export { type AgentSessionRuntimeDiagnostic, type AgentSessionServices, type CreateAgentSessionFromServicesOptions, type CreateAgentSessionServicesOptions, createAgentSessionFromServices, createAgentSessionServices, } from "./agent-session-services.ts";

package/dist/core/agent-session-runtime.js

@@ -0,0 +1 @@
+var v=Object.defineProperty;var l=(r,e)=>v(r,"name",{value:e,configurable:!0});import{copyFileSync as y,existsSync as m,mkdirSync as F}from"node:fs";import{basename as _,join as b,resolve as R}from"node:path";import{resolvePath as k}from"../utils/paths.js";import{emitSessionShutdownEvent as p}from"./extensions/runner.js";import{assertSessionCwdExists as g}from"./session-cwd.js";import{SessionManager as h}from"./session-manager.js";class M extends Error{static{l(this,"SessionImportFileNotFoundError")}filePath;constructor(e){super(`File not found: ${e}`),this.name="SessionImportFileNotFoundError",this.filePath=e}}function D(r){return typeof r=="string"?r:r.filter(e=>e.type==="text"&&typeof e.text=="string").map(e=>e.text).join("")}l(D,"extractUserMessageText");class x{static{l(this,"AgentSessionRuntime")}rebindSession;beforeSessionInvalidate;_session;_services;createRuntime;_diagnostics;_modelFallbackMessage;constructor(e,s,t,n=[],i){this._session=e,this._services=s,this.createRuntime=t,this._diagnostics=n,this._modelFallbackMessage=i}get services(){return this._services}get session(){return this._session}get cwd(){return this._services.cwd}get diagnostics(){return this._diagnostics}get modelFallbackMessage(){return this._modelFallbackMessage}setRebindSession(e){this.rebindSession=e}setBeforeSessionInvalidate(e){this.beforeSessionInvalidate=e}async emitBeforeSwitch(e,s){const t=this.session.extensionRunner;return t.hasHandlers("session_before_switch")?{cancelled:(await t.emit({type:"session_before_switch",reason:e,targetSessionFile:s}))?.cancel===!0}:{cancelled:!1}}async emitBeforeFork(e,s){const t=this.session.extensionRunner;return t.hasHandlers("session_before_fork")?{cancelled:(await t.emit({type:"session_before_fork",entryId:e,...s}))?.cancel===!0}:{cancelled:!1}}async teardownCurrent(e,s){await p(this.session.extensionRunner,{type:"session_shutdown",reason:e,targetSessionFile:s}),this.beforeSessionInvalidate?.(),this.session.dispose()}apply(e){this._session=e.session,this._services=e.services,this._diagnostics=e.diagnostics,this._modelFallbackMessage=e.modelFallbackMessage}async finishSessionReplacement(e){this.rebindSession&&await this.rebindSession(this.session),e&&await e(this.session.createReplacedSessionContext())}async switchSession(e,s){const t=await this.emitBeforeSwitch("resume",e);if(t.cancelled)return t;const n=this.session.sessionFile,i=h.open(e,void 0,s?.cwdOverride);return g(i,this.cwd),await this.teardownCurrent("resume",i.getSessionFile()),this.apply(await this.createRuntime({cwd:i.getCwd(),agentDir:this.services.agentDir,sessionManager:i,sessionStartEvent:{type:"session_start",reason:"resume",previousSessionFile:n}})),await this.finishSessionReplacement(s?.withSession),{cancelled:!1}}async newSession(e){const s=await this.emitBeforeSwitch("new");if(s.cancelled)return s;const t=this.session.sessionFile,n=this.session.sessionManager.getSessionDir(),i=h.create(this.cwd,n);return e?.parentSession&&i.newSession({parentSession:e.parentSession}),await this.teardownCurrent("new",i.getSessionFile()),this.apply(await this.createRuntime({cwd:this.cwd,agentDir:this.services.agentDir,sessionManager:i,sessionStartEvent:{type:"session_start",reason:"new",previousSessionFile:t}})),e?.setup&&(await e.setup(this.session.sessionManager),this.session.agent.state.messages=this.session.sessionManager.buildSessionContext().messages),await this.finishSessionReplacement(e?.withSession),{cancelled:!1}}async fork(e,s){const t=s?.position??"before";if((await this.emitBeforeFork(e,{position:t})).cancelled)return{cancelled:!0};let i,c;const o=this.session.sessionManager.getEntry(e);if(!o)throw new Error("Invalid entry ID for forking");if(t==="at")i=o.id;else{if(o.type!=="message"||o.message.role!=="user")throw new Error("Invalid entry ID for forking");i=o.parentId,c=D(o.message.content)}const a=this.session.sessionFile;if(this.session.sessionManager.isPersisted()){const w=this.session.sessionFile;if(!w)throw new Error("Persisted session is missing a session file");const S=this.session.sessionManager.getSessionDir();if(!i){const u=h.create(this.cwd,S);return u.newSession({parentSession:w}),await this.teardownCurrent("fork",u.getSessionFile()),this.apply(await this.createRuntime({cwd:this.cwd,agentDir:this.services.agentDir,sessionManager:u,sessionStartEvent:{type:"session_start",reason:"fork",previousSessionFile:a}})),await this.finishSessionReplacement(s?.withSession),{cancelled:!1,selectedText:c}}const f=h.open(w,S);if(!f.createBranchedSession(i))throw new Error("Failed to create forked session");return await this.teardownCurrent("fork",f.getSessionFile()),this.apply(await this.createRuntime({cwd:f.getCwd(),agentDir:this.services.agentDir,sessionManager:f,sessionStartEvent:{type:"session_start",reason:"fork",previousSessionFile:a}})),await this.finishSessionReplacement(s?.withSession),{cancelled:!1,selectedText:c}}const d=this.session.sessionManager;return i?d.createBranchedSession(i):d.newSession({parentSession:this.session.sessionFile}),await this.teardownCurrent("fork",d.getSessionFile()),this.apply(await this.createRuntime({cwd:this.cwd,agentDir:this.services.agentDir,sessionManager:d,sessionStartEvent:{type:"session_start",reason:"fork",previousSessionFile:a}})),await this.finishSessionReplacement(s?.withSession),{cancelled:!1,selectedText:c}}async importFromJsonl(e,s){const t=k(e);if(!m(t))throw new M(t);const n=this.session.sessionManager.getSessionDir();m(n)||F(n,{recursive:!0});const i=b(n,_(t)),c=await this.emitBeforeSwitch("resume",i);if(c.cancelled)return c;const o=this.session.sessionFile;R(i)!==t&&y(t,i);const a=h.open(i,n,s);return g(a,this.cwd),await this.teardownCurrent("resume",a.getSessionFile()),this.apply(await this.createRuntime({cwd:a.getCwd(),agentDir:this.services.agentDir,sessionManager:a,sessionStartEvent:{type:"session_start",reason:"resume",previousSessionFile:o}})),await this.finishSessionReplacement(),{cancelled:!1}}async dispose(){await p(this.session.extensionRunner,{type:"session_shutdown",reason:"quit"}),this.beforeSessionInvalidate?.(),this.session.dispose()}}async function N(r,e){g(e.sessionManager,e.cwd);const s=await r(e);return new x(s.session,s.services,r,s.diagnostics,s.modelFallbackMessage)}l(N,"createAgentSessionRuntime");import{createAgentSessionFromServices as J,createAgentSessionServices as L}from"./agent-session-services.js";export{x as AgentSessionRuntime,M as SessionImportFileNotFoundError,J as createAgentSessionFromServices,N as createAgentSessionRuntime,L as createAgentSessionServices};

package/dist/core/agent-session-services.d.ts

@@ -0,0 +1,86 @@
+import type { ThinkingLevel } from "@openadapter/koda-agent-core";
+import type { Model } from "@openadapter/koda-ai";
+import { AuthStorage } from "./auth-storage.ts";
+import type { SessionStartEvent, ToolDefinition } from "./extensions/index.ts";
+import { ModelRegistry } from "./model-registry.ts";
+import { type DefaultResourceLoaderOptions, type ResourceLoader } from "./resource-loader.ts";
+import { type CreateAgentSessionOptions, type CreateAgentSessionResult } from "./sdk.ts";
+import type { SessionManager } from "./session-manager.ts";
+import { SettingsManager } from "./settings-manager.ts";
+/**
+ * Non-fatal issues collected while creating services or sessions.
+ *
+ * Runtime creation returns diagnostics to the caller instead of printing or
+ * exiting. The app layer decides whether warnings should be shown and whether
+ * errors should abort startup.
+ */
+export interface AgentSessionRuntimeDiagnostic {
+    type: "info" | "warning" | "error";
+    message: string;
+}
+/**
+ * Inputs for creating cwd-bound runtime services.
+ *
+ * These services are recreated whenever the effective session cwd changes.
+ * CLI-provided resource paths should be resolved to absolute paths before they
+ * reach this function, so later cwd switches do not reinterpret them.
+ */
+export interface CreateAgentSessionServicesOptions {
+    cwd: string;
+    agentDir?: string;
+    authStorage?: AuthStorage;
+    settingsManager?: SettingsManager;
+    modelRegistry?: ModelRegistry;
+    extensionFlagValues?: Map<string, boolean | string>;
+    resourceLoaderOptions?: Omit<DefaultResourceLoaderOptions, "cwd" | "agentDir" | "settingsManager">;
+}
+/**
+ * Inputs for creating an AgentSession from already-created services.
+ *
+ * Use this after services exist and any cwd-bound model/tool/session options
+ * have been resolved against those services.
+ */
+export interface CreateAgentSessionFromServicesOptions {
+    services: AgentSessionServices;
+    sessionManager: SessionManager;
+    sessionStartEvent?: SessionStartEvent;
+    model?: Model<any>;
+    thinkingLevel?: ThinkingLevel;
+    scopedModels?: Array<{
+        model: Model<any>;
+        thinkingLevel?: ThinkingLevel;
+    }>;
+    tools?: string[];
+    excludeTools?: CreateAgentSessionOptions["excludeTools"];
+    noTools?: CreateAgentSessionOptions["noTools"];
+    customTools?: ToolDefinition[];
+}
+/**
+ * Coherent cwd-bound runtime services for one effective session cwd.
+ *
+ * This is infrastructure only. The AgentSession itself is created separately so
+ * session options can be resolved against these services first.
+ */
+export interface AgentSessionServices {
+    cwd: string;
+    agentDir: string;
+    authStorage: AuthStorage;
+    settingsManager: SettingsManager;
+    modelRegistry: ModelRegistry;
+    resourceLoader: ResourceLoader;
+    diagnostics: AgentSessionRuntimeDiagnostic[];
+}
+/**
+ * Create cwd-bound runtime services.
+ *
+ * Returns services plus diagnostics. It does not create an AgentSession.
+ */
+export declare function createAgentSessionServices(options: CreateAgentSessionServicesOptions): Promise<AgentSessionServices>;
+/**
+ * Create an AgentSession from previously created services.
+ *
+ * This keeps session creation separate from service creation so callers can
+ * resolve model, thinking, tools, and other session inputs against the target
+ * cwd before constructing the session.
+ */
+export declare function createAgentSessionFromServices(options: CreateAgentSessionFromServicesOptions): Promise<CreateAgentSessionResult>;

package/dist/core/agent-session-services.js

@@ -0,0 +1 @@
+var y=Object.defineProperty;var c=(e,t)=>y(e,"name",{value:t,configurable:!0});import{join as u}from"node:path";import{getAgentDir as x}from"../config.js";import{resolvePath as m}from"../utils/paths.js";import{AuthStorage as S}from"./auth-storage.js";import{ModelRegistry as p}from"./model-registry.js";import{DefaultResourceLoader as M}from"./resource-loader.js";import{createAgentSession as R}from"./sdk.js";import{SettingsManager as w}from"./settings-manager.js";function E(e,t){if(!t)return[];const s=[],i=e.getExtensions(),g=new Map;for(const r of i.extensions)for(const[n,a]of r.flags)g.set(n,{type:a.type});const o=[];for(const[r,n]of t){const a=g.get(r);if(!a){o.push(r);continue}if(a.type==="boolean"){i.runtime.flagValues.set(r,!0);continue}if(typeof n=="string"){i.runtime.flagValues.set(r,n);continue}s.push({type:"error",message:`Extension flag "--${r}" requires a value`})}return o.length>0&&s.push({type:"error",message:`Unknown option${o.length===1?"":"s"}: ${o.map(r=>`--${r}`).join(", ")}`}),s}c(E,"applyExtensionFlagValues");async function V(e){const t=m(e.cwd),s=e.agentDir?m(e.agentDir):x(),i=e.authStorage??S.create(u(s,"auth.json")),g=e.settingsManager??w.create(t,s),o=e.modelRegistry??p.create(i,u(s,"models.json")),r=new M({...e.resourceLoaderOptions??{},cwd:t,agentDir:s,settingsManager:g});await r.reload();const n=[],a=r.getExtensions();for(const{name:f,config:d,extensionPath:h}of a.runtime.pendingProviderRegistrations)try{o.registerProvider(f,d)}catch(l){const v=l instanceof Error?l.message:String(l);n.push({type:"error",message:`Extension "${h}" error: ${v}`})}return a.runtime.pendingProviderRegistrations=[],n.push(...E(r,e.extensionFlagValues)),{cwd:t,agentDir:s,authStorage:i,settingsManager:g,modelRegistry:o,resourceLoader:r,diagnostics:n}}c(V,"createAgentSessionServices");async function b(e){return R({cwd:e.services.cwd,agentDir:e.services.agentDir,authStorage:e.services.authStorage,settingsManager:e.services.settingsManager,modelRegistry:e.services.modelRegistry,resourceLoader:e.services.resourceLoader,sessionManager:e.sessionManager,model:e.model,thinkingLevel:e.thinkingLevel,scopedModels:e.scopedModels,tools:e.tools,excludeTools:e.excludeTools,noTools:e.noTools,customTools:e.customTools,sessionStartEvent:e.sessionStartEvent})}c(b,"createAgentSessionFromServices");export{b as createAgentSessionFromServices,V as createAgentSessionServices};