@fastagent-sh/fastagent 0.14.0 → 0.16.0

package/dist/engines/pi/workspace.js

@@ -1,72 +0,0 @@
-/**
- * Open a definition directory into an agent — the single workspace opener BOTH `fastagent dev` and
- * `fastagent start` drive.
- *
- * A thin command-posture composition over L2 `createPiAgentFromDefinition`: open the directory →
- * resolve model (flag > env > config) and tools (append-after-defaults) → pick session storage →
- * call L2. dev and start share the SAME assembly here (what you iterate is what you serve); they
- * differ only at the CLI — dev watches and uses the in-tree sessions default, start runs without
- * watch and can point sessions at a mounted volume.
- */
-import { mkdir } from "node:fs/promises";
-import { defaultAuthPath, defaultSessionsDir, loadConfig, resolveAgentDir, resolveModelSpec, resolveStateRoot, } from "./config.js";
-import { createPiAgentFromDefinition, resolveWorkspaceTools } from "./create.js";
-import { withWakeTool } from "./wake-tool.js";
-import { ensureStateRootSelfIgnored } from "./definition.js";
-import { jsonlSessionStore } from "./sessions.js";
-/**
- * "Point at a workspace → agent": load the config, resolve model and tools, then L2. Throws a clear
- * error when no model source is set (fail visibly at startup). Returns everything an entry point needs
- * to report what it assembled.
- */
-export async function createPiAgentFromWorkspace(dir, options = {}) {
-    const { config, path: configPath } = await loadConfig(dir);
-    const modelSpec = resolveModelSpec(options.model, config);
-    if (!modelSpec) {
-        throw new Error(`missing model: set --model, "model" in fastagent.config.ts, or FASTAGENT_MODEL (e.g. "openai-codex/gpt-5.5")`);
-    }
-    // The run root is `dir` (cwd — where config lives, whose AGENTS.md is ② context); the agent's own
-    // surface (persona/skills/tools/channels) lives in `agentDir` (config.agentDir, or `dir` when flat).
-    const agentDir = resolveAgentDir(dir, config);
-    const { tools, toolNames, deferredToolNames, toolCollisions, toolFailures } = await resolveWorkspaceTools(config, agentDir, dir);
-    // The state root: auth/sessions/channel state all derive from it, so FASTAGENT_STATE_DIR moves the
-    // whole machine-state home in one knob (a container mounts one volume); the finer overrides below
-    // still win for their specific path.
-    const stateRoot = resolveStateRoot(dir);
-    // Mount the built-in `wake` tool only when BOTH: this is a long-running serve (the poller honors it) AND
-    // the author opted into self-scheduling (config.selfSchedule). The workspace's own `wake` wins if defined.
-    const mountedTools = withWakeTool(tools, stateRoot, !!options.serving && !!config.selfSchedule);
-    const sessionsDir = options.sessionsDir ?? defaultSessionsDir(stateRoot);
-    await mkdir(sessionsDir, { recursive: true });
-    // The credentials file: project-level by default (under the self-ignored state root); only READ here,
-    // so no mkdir (a missing file reads as not-configured — `fastagent login` creates it).
-    const authPath = options.authPath ?? defaultAuthPath(stateRoot);
-    // Self-ignore the state root iff it lands in-tree — which covers everything under it (sessions, auth,
-    // every channel's `channels/<kind>` home), including a custom in-tree `FASTAGENT_STATE_DIR`. A
-    // per-path override to an external volume is out-of-tree and correctly left alone.
-    await ensureStateRootSelfIgnored(dir, stateRoot);
-    const { agent, definition } = await createPiAgentFromDefinition(agentDir, {
-        model: modelSpec,
-        thinkingLevel: config.thinkingLevel,
-        cwd: dir,
-        tools: mountedTools,
-        authPath,
-        // Skills are definition-only (the agent is its directory), so dev mirrors deployment exactly.
-        sessions: jsonlSessionStore({ dir: sessionsDir, cwd: dir }),
-    });
-    return {
-        agent,
-        definition,
-        agentDir,
-        config,
-        configPath,
-        modelSpec,
-        stateRoot,
-        sessionsDir,
-        authPath,
-        toolNames,
-        deferredToolNames,
-        toolCollisions,
-        toolFailures,
-    };
-}

package/dist/scaffold/templates/gitignore.agentdir-root

@@ -1,5 +0,0 @@
-# secrets — never commit (kept out of git and any deploy copy)
-.env
-
-# fastagent machine state (dev/start sessions + project-level auth.json credentials)
-.fastagent/

package/dist/scaffold/templates/gitignore.kit

@@ -1,2 +0,0 @@
-# dependencies (reinstalled at deploy)
-node_modules/

package/dist/workspace.d.ts

@@ -1,9 +0,0 @@
-import { type Ignore } from "ignore";
-/**
- * Guard that `<workspaceDir>/<name>` resolves INSIDE the workspace — a symlink that escapes (or an
- * absolute target) is rejected, so discovery/scaffolding never reaches out of the definition directory.
- * A missing target is fine (nothing to guard yet).
- */
-export declare function assertInsideWorkspace(workspaceDir: string, name: string): Promise<void>;
-/** Load `.gitignore` + `.fastagentignore` from `dir` into one matcher (case-sensitive), or undefined if none. */
-export declare function loadRootIgnore(dir: string): Promise<Ignore | undefined>;

package/dist/workspace.js

@@ -1,45 +0,0 @@
-/**
- * Workspace path/ignore utilities — engine-neutral (pure fs/path + the `ignore` matcher). Shared by the
- * scaffold (init/add) and the engine's channel discovery, so they live here, not under engines/pi.
- */
-import { readFile, realpath } from "node:fs/promises";
-import { isAbsolute, join, relative, resolve } from "node:path";
-import ignore, {} from "ignore";
-/**
- * Guard that `<workspaceDir>/<name>` resolves INSIDE the workspace — a symlink that escapes (or an
- * absolute target) is rejected, so discovery/scaffolding never reaches out of the definition directory.
- * A missing target is fine (nothing to guard yet).
- */
-export async function assertInsideWorkspace(workspaceDir, name) {
-    const target = join(workspaceDir, name);
-    const real = await realpath(target).catch((e) => {
-        if (e.code === "ENOENT" || e.code === "not_found")
-            return undefined;
-        throw e;
-    });
-    if (real === undefined)
-        return;
-    const root = await realpath(workspaceDir).catch(() => resolve(workspaceDir));
-    const rel = relative(root, real);
-    if (rel === "" || rel.startsWith("..") || isAbsolute(rel)) {
-        throw new Error(`${target} resolves outside the workspace (${real}) — it must live inside the definition directory; ` +
-            `use a real directory or a symlink that stays within it`);
-    }
-}
-/** Load `.gitignore` + `.fastagentignore` from `dir` into one matcher (case-sensitive), or undefined if none. */
-export async function loadRootIgnore(dir) {
-    let rules = "";
-    for (const name of [".gitignore", ".fastagentignore"]) {
-        try {
-            rules += `\n${await readFile(join(dir, name), "utf8")}`;
-        }
-        catch (error) {
-            if (error.code !== "ENOENT") {
-                throw new Error(`cannot read ${join(dir, name)}: ${error.message}`);
-            }
-        }
-    }
-    // ignorecase:false — the library defaults to case-INSENSITIVE, which would make a rule `README.md`
-    // also drop an authored `readme.md`. Match git on a case-sensitive filesystem, reproducibly.
-    return rules.trim() === "" ? undefined : ignore({ ignorecase: false }).add(rules);
-}