@hoangsonw/forge 0.1.0

package/dist/tools/web-fetch.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webFetchTool = void 0;
+const fetch_1 = require("../web/fetch");
+const errors_1 = require("../types/errors");
+exports.webFetchTool = {
+    schema: {
+        name: 'web.fetch',
+        description: 'Download a webpage and return cleaned text + title.',
+        sideEffect: 'network',
+        risk: 'medium',
+        permissionDefault: 'ask',
+        sensitivity: 'medium',
+        timeoutMs: 20_000,
+        inputSchema: {
+            type: 'object',
+            required: ['url'],
+            properties: {
+                url: { type: 'string' },
+                maxBytes: { type: 'number' },
+                maxChars: { type: 'number' },
+                timeoutMs: { type: 'number' },
+            },
+        },
+    },
+    async execute(args) {
+        const start = Date.now();
+        try {
+            const out = await (0, fetch_1.webFetch)(args);
+            return { success: true, output: out, durationMs: Date.now() - start };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof errors_1.ForgeRuntimeError
+                    ? err.toJSON()
+                    : { class: 'tool_error', message: String(err), retryable: true },
+                durationMs: Date.now() - start,
+            };
+        }
+    },
+};
+//# sourceMappingURL=web-fetch.js.map

package/dist/tools/web-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.js","sourceRoot":"","sources":["../../src/tools/web-fetch.ts"],"names":[],"mappings":";;;AACA,wCAAqD;AACrD,4CAAoD;AASvC,QAAA,YAAY,GAA4B;IACnD,MAAM,EAAE;QACN,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,qDAAqD;QAClE,UAAU,EAAE,SAAS;QACrB,IAAI,EAAE,QAAQ;QACd,iBAAiB,EAAE,KAAK;QACxB,WAAW,EAAE,QAAQ;QACrB,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,KAAK,CAAC;YACjB,UAAU,EAAE;gBACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACvB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC5B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC5B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC9B;SACF;KACF;IACD,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAA,gBAAQ,EAAC,IAAI,CAAC,CAAC;YACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;QACxE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EACH,GAAG,YAAY,0BAAiB;oBAC9B,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE;oBACd,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE;gBACpE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/web-search.d.ts

@@ -0,0 +1,12 @@
+import { Tool } from '../types';
+import { SearchResult } from '../web/search';
+interface Args {
+    query: string;
+    limit?: number;
+}
+export declare const webSearchTool: Tool<Args, {
+    results: SearchResult[];
+    provider: string;
+}>;
+export {};
+//# sourceMappingURL=web-search.d.ts.map

package/dist/tools/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../src/tools/web-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAc,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAa,YAAY,EAAE,MAAM,eAAe,CAAC;AAGxD,UAAU,IAAI;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,aAAa,EAAE,IAAI,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAsCnF,CAAC"}

package/dist/tools/web-search.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webSearchTool = void 0;
+const search_1 = require("../web/search");
+const errors_1 = require("../types/errors");
+exports.webSearchTool = {
+    schema: {
+        name: 'web.search',
+        description: 'Search the web. Uses Tavily → Brave → DuckDuckGo depending on configured keys.',
+        sideEffect: 'network',
+        risk: 'low',
+        permissionDefault: 'ask',
+        sensitivity: 'low',
+        timeoutMs: 20_000,
+        inputSchema: {
+            type: 'object',
+            required: ['query'],
+            properties: {
+                query: { type: 'string' },
+                limit: { type: 'number' },
+            },
+        },
+    },
+    async execute(args) {
+        const start = Date.now();
+        try {
+            const results = await (0, search_1.webSearch)({ query: args.query, limit: args.limit });
+            return {
+                success: true,
+                output: { results, provider: inferProvider() },
+                durationMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof errors_1.ForgeRuntimeError
+                    ? err.toJSON()
+                    : { class: 'tool_error', message: String(err), retryable: true },
+                durationMs: Date.now() - start,
+            };
+        }
+    },
+};
+const inferProvider = () => {
+    if (process.env.TAVILY_API_KEY)
+        return 'tavily';
+    if (process.env.BRAVE_SEARCH_API_KEY)
+        return 'brave';
+    return 'duckduckgo';
+};
+//# sourceMappingURL=web-search.js.map

package/dist/tools/web-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.js","sourceRoot":"","sources":["../../src/tools/web-search.ts"],"names":[],"mappings":";;;AACA,0CAAwD;AACxD,4CAAoD;AAOvC,QAAA,aAAa,GAA8D;IACtF,MAAM,EAAE;QACN,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,gFAAgF;QAC7F,UAAU,EAAE,SAAS;QACrB,IAAI,EAAE,KAAK;QACX,iBAAiB,EAAE,KAAK;QACxB,WAAW,EAAE,KAAK;QAClB,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,OAAO,CAAC;YACnB,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC1B;SACF;KACF;IACD,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAA,kBAAS,EAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAC1E,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE;gBAC9C,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EACH,GAAG,YAAY,0BAAiB;oBAC9B,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE;oBACd,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE;gBACpE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEF,MAAM,aAAa,GAAG,GAAW,EAAE;IACjC,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QAAE,OAAO,QAAQ,CAAC;IAChD,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB;QAAE,OAAO,OAAO,CAAC;IACrD,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC"}

package/dist/tools/write-file.d.ts

@@ -0,0 +1,13 @@
+import { Tool } from '../types';
+interface Args {
+    path: string;
+    content: string;
+    createDirs?: boolean;
+    mode?: 'overwrite' | 'create_only' | 'append';
+}
+export declare const writeFileTool: Tool<Args, {
+    bytesWritten: number;
+    existed: boolean;
+}>;
+export {};
+//# sourceMappingURL=write-file.d.ts.map

package/dist/tools/write-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.d.ts","sourceRoot":"","sources":["../../src/tools/write-file.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAc,MAAM,UAAU,CAAC;AAI5C,UAAU,IAAI;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,QAAQ,CAAC;CAC/C;AAED,eAAO,MAAM,aAAa,EAAE,IAAI,CAAC,IAAI,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAyDhF,CAAC"}

package/dist/tools/write-file.js

@@ -0,0 +1,100 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeFileTool = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const errors_1 = require("../types/errors");
+const fs_1 = require("../sandbox/fs");
+exports.writeFileTool = {
+    schema: {
+        name: 'write_file',
+        description: 'Write (create/overwrite/append) a text file inside the sandbox.',
+        sideEffect: 'write',
+        risk: 'medium',
+        permissionDefault: 'ask',
+        sensitivity: 'medium',
+        timeoutMs: 15_000,
+        inputSchema: {
+            type: 'object',
+            required: ['path', 'content'],
+            properties: {
+                path: { type: 'string' },
+                content: { type: 'string' },
+                createDirs: { type: 'boolean' },
+                mode: { type: 'string', enum: ['overwrite', 'create_only', 'append'] },
+            },
+        },
+    },
+    async execute(args, ctx) {
+        const start = Date.now();
+        try {
+            const real = (0, fs_1.resolveSafe)(args.path, { projectRoot: ctx.projectRoot }, 'write');
+            const existed = fs.existsSync(real);
+            if (args.mode === 'create_only' && existed) {
+                throw new errors_1.ForgeRuntimeError({
+                    class: 'conflict',
+                    message: `${args.path} already exists (mode=create_only).`,
+                    retryable: false,
+                });
+            }
+            if (args.createDirs) {
+                fs.mkdirSync(path.dirname(real), { recursive: true });
+            }
+            if (args.mode === 'append') {
+                fs.appendFileSync(real, args.content, { encoding: 'utf8' });
+            }
+            else {
+                fs.writeFileSync(real, args.content, { encoding: 'utf8' });
+            }
+            const stat = fs.statSync(real);
+            return {
+                success: true,
+                output: { bytesWritten: stat.size, existed },
+                durationMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof errors_1.ForgeRuntimeError
+                    ? err.toJSON()
+                    : { class: 'tool_error', message: String(err), retryable: false },
+                durationMs: Date.now() - start,
+            };
+        }
+    },
+};
+//# sourceMappingURL=write-file.js.map

package/dist/tools/write-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.js","sourceRoot":"","sources":["../../src/tools/write-file.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAE7B,4CAAoD;AACpD,sCAA4C;AAS/B,QAAA,aAAa,GAA2D;IACnF,MAAM,EAAE;QACN,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,iEAAiE;QAC9E,UAAU,EAAE,OAAO;QACnB,IAAI,EAAE,QAAQ;QACd,iBAAiB,EAAE,KAAK;QACxB,WAAW,EAAE,QAAQ;QACrB,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;YAC7B,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACxB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC3B,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;gBAC/B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE;aACvE;SACF;KACF;IACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAA,gBAAW,EAAC,IAAI,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;YAC/E,MAAM,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,IAAI,OAAO,EAAE,CAAC;gBAC3C,MAAM,IAAI,0BAAiB,CAAC;oBAC1B,KAAK,EAAE,UAAU;oBACjB,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,qCAAqC;oBAC1D,SAAS,EAAE,KAAK;iBACjB,CAAC,CAAC;YACL,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,CAAC;YACD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC3B,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9D,CAAC;iBAAM,CAAC;gBACN,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YAC7D,CAAC;YACD,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE;gBAC5C,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EACH,GAAG,YAAY,0BAAiB;oBAC9B,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE;oBACd,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE;gBACrE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/types/errors.d.ts

@@ -0,0 +1,14 @@
+import { ErrorClass, ForgeError } from './index';
+export declare class ForgeRuntimeError extends Error implements ForgeError {
+    readonly class: ErrorClass;
+    readonly retryable: boolean;
+    readonly recoveryHint?: string;
+    readonly cause?: unknown;
+    readonly traceId?: string;
+    constructor(params: ForgeError);
+    toJSON(): ForgeError;
+}
+export declare const isRetryable: (err: unknown) => boolean;
+export declare const classify: (err: unknown, fallback?: ErrorClass) => ErrorClass;
+export declare const wrap: (err: unknown, klass: ErrorClass, message: string) => ForgeRuntimeError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjD,qBAAa,iBAAkB,SAAQ,KAAM,YAAW,UAAU;IAChE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEd,MAAM,EAAE,UAAU;IAU9B,MAAM,IAAI,UAAU;CAUrB;AAED,eAAO,MAAM,WAAW,GAAI,KAAK,OAAO,KAAG,OAM1C,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,KAAK,OAAO,EAAE,WAAU,UAAuB,KAAG,UAG1E,CAAC;AAEF,eAAO,MAAM,IAAI,GAAI,KAAK,OAAO,EAAE,OAAO,UAAU,EAAE,SAAS,MAAM,KAAG,iBAOvE,CAAC"}

package/dist/types/errors.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrap = exports.classify = exports.isRetryable = exports.ForgeRuntimeError = void 0;
+class ForgeRuntimeError extends Error {
+    class;
+    retryable;
+    recoveryHint;
+    cause;
+    traceId;
+    constructor(params) {
+        super(params.message);
+        this.name = 'ForgeRuntimeError';
+        this.class = params.class;
+        this.retryable = params.retryable;
+        this.recoveryHint = params.recoveryHint;
+        this.cause = params.cause;
+        this.traceId = params.traceId;
+    }
+    toJSON() {
+        return {
+            class: this.class,
+            message: this.message,
+            retryable: this.retryable,
+            recoveryHint: this.recoveryHint,
+            cause: this.cause ? String(this.cause) : undefined,
+            traceId: this.traceId,
+        };
+    }
+}
+exports.ForgeRuntimeError = ForgeRuntimeError;
+const isRetryable = (err) => {
+    if (err instanceof ForgeRuntimeError)
+        return err.retryable;
+    if (err && typeof err === 'object' && 'retryable' in err) {
+        return Boolean(err.retryable);
+    }
+    return false;
+};
+exports.isRetryable = isRetryable;
+const classify = (err, fallback = 'internal') => {
+    if (err instanceof ForgeRuntimeError)
+        return err.class;
+    return fallback;
+};
+exports.classify = classify;
+const wrap = (err, klass, message) => {
+    return new ForgeRuntimeError({
+        class: klass,
+        message,
+        retryable: false,
+        cause: err,
+    });
+};
+exports.wrap = wrap;
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":";;;AAEA,MAAa,iBAAkB,SAAQ,KAAK;IACjC,KAAK,CAAa;IAClB,SAAS,CAAU;IACnB,YAAY,CAAU;IACtB,KAAK,CAAW;IAChB,OAAO,CAAU;IAE1B,YAAY,MAAkB;QAC5B,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,MAAM;QACJ,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;YAClD,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AA3BD,8CA2BC;AAEM,MAAM,WAAW,GAAG,CAAC,GAAY,EAAW,EAAE;IACnD,IAAI,GAAG,YAAY,iBAAiB;QAAE,OAAO,GAAG,CAAC,SAAS,CAAC;IAC3D,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,WAAW,IAAI,GAAG,EAAE,CAAC;QACzD,OAAO,OAAO,CAAE,GAA8B,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AANW,QAAA,WAAW,eAMtB;AAEK,MAAM,QAAQ,GAAG,CAAC,GAAY,EAAE,WAAuB,UAAU,EAAc,EAAE;IACtF,IAAI,GAAG,YAAY,iBAAiB;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC;IACvD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAHW,QAAA,QAAQ,YAGnB;AAEK,MAAM,IAAI,GAAG,CAAC,GAAY,EAAE,KAAiB,EAAE,OAAe,EAAqB,EAAE;IAC1F,OAAO,IAAI,iBAAiB,CAAC;QAC3B,KAAK,EAAE,KAAK;QACZ,OAAO;QACP,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,GAAG;KACX,CAAC,CAAC;AACL,CAAC,CAAC;AAPW,QAAA,IAAI,QAOf"}

package/dist/types/index.d.ts

@@ -0,0 +1,267 @@
+/**
+ * Forge shared contracts.
+ *
+ * These types cross every layer (CLI, core, agents, persistence). Treat them
+ * as load-bearing: if a field is added here, persistence/migrations need to
+ * follow. Names match the planning docs verbatim where possible so that a
+ * grep-driven audit of the spec is trivial.
+ */
+export type TaskStatus = 'draft' | 'planned' | 'approved' | 'scheduled' | 'running' | 'verifying' | 'completed' | 'failed' | 'blocked' | 'cancelled';
+export declare const TERMINAL_STATUSES: ReadonlySet<TaskStatus>;
+export type Mode = 'fast' | 'balanced' | 'heavy' | 'plan' | 'execute' | 'audit' | 'debug' | 'architect' | 'offline-safe';
+export declare const DEFAULT_MODE: Mode;
+export type TaskType = 'bugfix' | 'feature' | 'refactor' | 'analysis' | 'setup' | 'test' | 'optimization' | 'other';
+export type Complexity = 'trivial' | 'simple' | 'moderate' | 'complex';
+export type Risk = 'low' | 'medium' | 'high' | 'critical';
+export type Scope = 'single-file' | 'multi-file' | 'multi-module' | 'system-wide';
+export interface TaskProfile {
+    intent: TaskType;
+    secondary: TaskType[];
+    complexity: Complexity;
+    scope: Scope;
+    risk: Risk;
+    requiresPlan: boolean;
+    requiresTests: boolean;
+    requiresReview: boolean;
+    agents: string[];
+    skills: string[];
+    explanation: string;
+}
+export type StepType = 'analyze' | 'plan' | 'edit_file' | 'apply_patch' | 'create_file' | 'delete_file' | 'run_command' | 'run_tests' | 'review' | 'debug' | 'retrieve_context' | 'ask_user' | 'custom';
+export interface PlanStep {
+    id: string;
+    type: StepType;
+    description: string;
+    target?: string;
+    args?: Record<string, unknown>;
+    dependsOn?: string[];
+    risk?: Risk;
+    estimatedSeconds?: number;
+    tool?: string;
+    agent?: string;
+}
+export interface Plan {
+    id: string;
+    goal: string;
+    steps: PlanStep[];
+    createdAt: string;
+    mode: Mode;
+    version: string;
+}
+export interface TaskResult {
+    success: boolean;
+    summary: string;
+    filesChanged: string[];
+    testsPassed?: boolean;
+    durationMs: number;
+    errors?: ForgeError[];
+    whatChanged?: string;
+    whyChanged?: string;
+    alternativesConsidered?: string[];
+    costUsd?: number;
+    tokensUsed?: number;
+}
+export interface Task {
+    id: string;
+    projectId: string;
+    title: string;
+    description?: string;
+    status: TaskStatus;
+    mode: Mode;
+    profile?: TaskProfile;
+    plan?: Plan;
+    parentTaskId?: string;
+    dependencies: string[];
+    traceId: string;
+    runId: string;
+    createdAt: string;
+    updatedAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    result?: TaskResult;
+    attempts: number;
+    maxAttempts: number;
+}
+export type EventType = 'TASK_CREATED' | 'TASK_CLASSIFIED' | 'TASK_PLANNED' | 'TASK_APPROVED' | 'TASK_SCHEDULED' | 'TASK_STARTED' | 'TASK_STEP_STARTED' | 'TASK_STEP_COMPLETED' | 'TASK_STEP_FAILED' | 'TASK_VERIFYING' | 'TASK_COMPLETED' | 'TASK_FAILED' | 'TASK_BLOCKED' | 'TASK_CANCELLED' | 'TOOL_CALLED' | 'TOOL_COMPLETED' | 'TOOL_FAILED' | 'MODEL_CALLED' | 'MODEL_COMPLETED' | 'MODEL_FAILED' | 'PERMISSION_REQUESTED' | 'PERMISSION_GRANTED' | 'PERMISSION_DENIED' | 'INPUT_REQUIRED' | 'INPUT_RECEIVED' | 'RETRY_ATTEMPTED' | 'ESCALATED' | 'UPDATE_AVAILABLE' | 'LEARNING_PATTERN_STORED' | 'MCP_CONNECTION_CHANGED';
+export type Severity = 'info' | 'warning' | 'error' | 'critical';
+export interface ForgeEvent {
+    type: EventType;
+    taskId?: string;
+    projectId?: string;
+    traceId?: string;
+    runId?: string;
+    severity: Severity;
+    message: string;
+    payload?: Record<string, unknown>;
+    timestamp: string;
+}
+export interface SessionEntry {
+    type: 'user' | 'assistant' | 'plan' | 'tool_call' | 'tool_result' | 'result' | 'event';
+    agent?: string;
+    content: unknown;
+    timestamp: string;
+    traceId?: string;
+}
+export type ModelRole = 'planner' | 'architect' | 'executor' | 'reviewer' | 'debugger' | 'fast';
+export interface ModelDescriptor {
+    provider: string;
+    id: string;
+    class: 'micro' | 'mid' | 'heavy' | 'specialized';
+    contextTokens: number;
+    supportsStreaming?: boolean;
+    roles: ModelRole[];
+}
+export interface ModelMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface ModelCallOptions {
+    temperature?: number;
+    maxTokens?: number;
+    deterministic?: boolean;
+    timeoutMs?: number;
+    jsonMode?: boolean;
+    stop?: string[];
+}
+export interface ModelResponse {
+    content: string;
+    model: string;
+    provider: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    durationMs: number;
+    finishReason?: 'stop' | 'length' | 'error' | 'tool_call';
+}
+export interface ModelProvider {
+    readonly name: string;
+    isAvailable(): Promise<boolean>;
+    listModels(): Promise<ModelDescriptor[]>;
+    complete(model: string, messages: ModelMessage[], options?: ModelCallOptions): Promise<ModelResponse>;
+}
+export type PromptLayer = 'system_core' | 'mode' | 'global_instructions' | 'project_instructions' | 'task_instructions' | 'context' | 'tools' | 'user_input';
+export interface PromptSegment {
+    layer: PromptLayer;
+    content: string;
+    priority: number;
+    tokens?: number;
+}
+export interface AssembledPrompt {
+    messages: ModelMessage[];
+    manifest: PromptSegment[];
+    hash: string;
+    mode: Mode;
+    version: string;
+}
+export type SideEffect = 'pure' | 'readonly' | 'write' | 'network' | 'execute';
+export interface ToolSchema {
+    name: string;
+    description: string;
+    sideEffect: SideEffect;
+    risk: Risk;
+    permissionDefault: 'ask' | 'allow' | 'deny';
+    sensitivity: 'low' | 'medium' | 'high';
+    timeoutMs: number;
+    inputSchema: Record<string, unknown>;
+}
+export interface ToolContext {
+    taskId: string;
+    projectId: string;
+    projectRoot: string;
+    traceId: string;
+    runId: string;
+}
+export interface ToolResult<T = unknown> {
+    success: boolean;
+    output?: T;
+    error?: ForgeError;
+    durationMs: number;
+}
+export interface Tool<TArgs = Record<string, unknown>, TOutput = unknown> {
+    schema: ToolSchema;
+    execute(args: TArgs, ctx: ToolContext): Promise<ToolResult<TOutput>>;
+}
+export interface AgentManifest {
+    name: string;
+    description: string;
+    capabilities: string[];
+    defaultMode: Mode;
+    tools: string[];
+    skills: string[];
+    behavior?: string;
+}
+export interface AgentContext {
+    task: Task;
+    projectRoot: string;
+    mode: Mode;
+}
+export interface SkillManifest {
+    name: string;
+    description: string;
+    inputs: string[];
+    tools: string[];
+    tags: string[];
+    body: string;
+}
+export type PermissionDecision = 'allow' | 'deny' | 'allow_session' | 'ask';
+export interface PermissionRequest {
+    tool: string;
+    risk: Risk;
+    sideEffect: SideEffect;
+    sensitivity: 'low' | 'medium' | 'high';
+    action: string;
+    target?: string;
+    projectId: string;
+    taskId?: string;
+}
+export interface PermissionGrant {
+    tool: string;
+    scope: 'once' | 'session' | 'project' | 'global';
+    grantedAt: string;
+    expiresAt?: string;
+}
+export type ErrorClass = 'user_input' | 'permission_denied' | 'policy_violation' | 'sandbox_violation' | 'injection_attempt' | 'model_error' | 'tool_error' | 'plan_invalid' | 'state_invalid' | 'resource_exhausted' | 'timeout' | 'retry_exhausted' | 'not_found' | 'conflict' | 'internal';
+export interface ForgeError {
+    class: ErrorClass;
+    message: string;
+    retryable: boolean;
+    recoveryHint?: string;
+    cause?: unknown;
+    traceId?: string;
+}
+export interface ProjectIdentity {
+    id: string;
+    path: string;
+    name: string;
+    createdAt: string;
+    lastOpened: string;
+}
+export type McpTransport = 'stdio' | 'http_stream' | 'websocket';
+export type McpAuthMethod = 'none' | 'api_key' | 'oauth' | 'basic';
+export interface McpConnection {
+    id: string;
+    name: string;
+    transport: McpTransport;
+    endpoint?: string;
+    command?: string;
+    args?: string[];
+    auth: McpAuthMethod;
+    status: 'connected' | 'disconnected' | 'error' | 'reauth_required';
+    lastUsedAt?: string;
+    tools?: string[];
+}
+export interface CompletionPolicy {
+    requireTests: boolean;
+    requireReview: boolean;
+    allowWarnings: boolean;
+}
+export interface ExecutionLimits {
+    maxSteps: number;
+    maxToolCalls: number;
+    maxRetries: number;
+    maxRuntimeSeconds: number;
+}
+export declare const DEFAULT_EXECUTION_LIMITS: ExecutionLimits;
+export declare const DEFAULT_COMPLETION_POLICY: CompletionPolicy;
+export declare const INSTRUCTION_PRIORITY: readonly ["system_safety", "page_rules", "mode_rules", "approved_task_plan", "project_defaults", "user_preferences"];
+export type InstructionLayer = (typeof INSTRUCTION_PRIORITY)[number];
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Forge shared contracts.
+ *
+ * These types cross every layer (CLI, core, agents, persistence). Treat them
+ * as load-bearing: if a field is added here, persistence/migrations need to
+ * follow. Names match the planning docs verbatim where possible so that a
+ * grep-driven audit of the spec is trivial.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INSTRUCTION_PRIORITY = exports.DEFAULT_COMPLETION_POLICY = exports.DEFAULT_EXECUTION_LIMITS = exports.DEFAULT_MODE = exports.TERMINAL_STATUSES = void 0;
+exports.TERMINAL_STATUSES = new Set([
+    'completed',
+    'failed',
+    'cancelled',
+]);
+exports.DEFAULT_MODE = 'balanced';
+exports.DEFAULT_EXECUTION_LIMITS = {
+    maxSteps: 50,
+    maxToolCalls: 100,
+    maxRetries: 3,
+    maxRuntimeSeconds: 600,
+};
+exports.DEFAULT_COMPLETION_POLICY = {
+    requireTests: false,
+    requireReview: true,
+    allowWarnings: true,
+};
+// ---------- Priority order (authoritative) ----------
+exports.INSTRUCTION_PRIORITY = [
+    'system_safety',
+    'page_rules',
+    'mode_rules',
+    'approved_task_plan',
+    'project_defaults',
+    'user_preferences',
+];
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAgBU,QAAA,iBAAiB,GAA4B,IAAI,GAAG,CAAC;IAChE,WAAW;IACX,QAAQ;IACR,WAAW;CACZ,CAAC,CAAC;AAeU,QAAA,YAAY,GAAS,UAAU,CAAC;AA8YhC,QAAA,wBAAwB,GAAoB;IACvD,QAAQ,EAAE,EAAE;IACZ,YAAY,EAAE,GAAG;IACjB,UAAU,EAAE,CAAC;IACb,iBAAiB,EAAE,GAAG;CACvB,CAAC;AAEW,QAAA,yBAAyB,GAAqB;IACzD,YAAY,EAAE,KAAK;IACnB,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF,uDAAuD;AAE1C,QAAA,oBAAoB,GAAG;IAClC,eAAe;IACf,YAAY;IACZ,YAAY;IACZ,oBAAoB;IACpB,kBAAkB;IAClB,kBAAkB;CACV,CAAC"}