terry-core 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,199 @@
+export type PermissionLevel = "disabled" | "enabled" | "ask";
+export type AgentMode = "general" | "focus" | "builder";
+export type ExecutionMode = "plan" | "safe" | "autonomous";
+export type ToolName = "listDirectory" | "readFile" | "writeFile" | "searchInFiles" | "gitStatus" | "gitDiff" | "runCommand";
+export type ToolArgsMap = {
+    listDirectory: {
+        pathRelativeToWorkspace?: string;
+    };
+    readFile: {
+        pathRelativeToWorkspace: string;
+    };
+    writeFile: {
+        pathRelativeToWorkspace: string;
+        content: string;
+    };
+    searchInFiles: {
+        query: string;
+    };
+    gitStatus: Record<string, never>;
+    gitDiff: {
+        path?: string;
+    };
+    runCommand: {
+        cmd: string;
+        args?: string[];
+        cwdRelativeToWorkspace?: string;
+    };
+};
+export type ToolResult = {
+    ok: boolean;
+    output?: string;
+    files?: string[];
+    error?: string;
+    patchProposalId?: string;
+};
+export type AuditEntry = {
+    timestamp: string;
+    workspace: string;
+    tool: ToolName;
+    args: unknown;
+    affectedFiles: string[];
+    dryRun: boolean;
+    ok: boolean;
+    error?: string;
+};
+export type ToolPolicy = Record<ToolName, PermissionLevel>;
+export type WorkspaceSettings = {
+    workspacePath: string;
+    dryRun: boolean;
+    mode: AgentMode;
+    executionMode: ExecutionMode;
+    tools: ToolPolicy;
+    goal?: string;
+};
+export type AgentMessage = {
+    role: "user" | "assistant" | "system";
+    content: string;
+};
+export type PlannedAction = {
+    kind: "ask_permission";
+    tool: ToolName;
+    args: unknown;
+    reason: string;
+} | {
+    kind: "summarize";
+    summary: string;
+};
+export type DecideNextAction = (messages: AgentMessage[], tools: ToolName[]) => PlannedAction;
+export type PatchRiskLevel = "low" | "medium" | "high";
+export type PatchStatus = "pending" | "applied" | "rejected";
+export type PatchHunk = {
+    id: string;
+    header: string;
+    before: string[];
+    after: string[];
+    approved: boolean;
+};
+export type PatchProposal = {
+    id: string;
+    filePath: string;
+    unifiedDiff: string;
+    hunks: PatchHunk[];
+    riskLevel: PatchRiskLevel;
+    status: PatchStatus;
+    createdAt: string;
+    updatedAt: string;
+    originalContent: string;
+    updatedContent: string;
+};
+export type ActionExplanation = {
+    id: string;
+    timestamp: string;
+    task: string;
+    mode: AgentMode;
+    executionMode: ExecutionMode;
+    reason: string;
+    chosenTool?: ToolName;
+    toolArgs?: unknown;
+    changedFiles: string[];
+    risks: string[];
+    summary: string;
+};
+export type SessionStepType = "plan" | "approval" | "tool" | "summary" | "status";
+export type SessionStep = {
+    at: string;
+    type: SessionStepType;
+    input?: string;
+    output?: string;
+    tool?: ToolName | "cloud-chat";
+    approval?: boolean;
+    durationMs?: number;
+};
+export type SessionRecord = {
+    id: string;
+    workspaceHash: string;
+    workspacePath: string;
+    task: string;
+    startedAt: string;
+    finishedAt?: string;
+    mode: AgentMode;
+    executionMode: ExecutionMode;
+    steps: SessionStep[];
+    result?: "success" | "failure" | "cancelled";
+};
+export type RepoGraphNode = {
+    id: string;
+    path: string;
+    kind: "file";
+};
+export type RepoGraphEdge = {
+    from: string;
+    to: string;
+    type: "import" | "reference" | "dependency";
+};
+export type RepoProfile = {
+    language: string;
+    framework: string;
+    buildSystem: string;
+    testRunner: string;
+    packageManager: string;
+};
+export type RepoGraph = {
+    nodes: RepoGraphNode[];
+    edges: RepoGraphEdge[];
+    metadata: {
+        generatedAt: string;
+        workspacePath: string;
+        profile: RepoProfile;
+    };
+};
+export type ImpactResult = {
+    target: string;
+    affectedFiles: string[];
+    confidence: number;
+    rationale: string;
+};
+export type HealthCheck = {
+    name: string;
+    status: "pass" | "warn" | "fail";
+    detail: string;
+};
+export type HealthReport = {
+    score: number;
+    checks: HealthCheck[];
+    recommendations: string[];
+    generatedAt: string;
+};
+export type UsageEntry = {
+    timestamp: string;
+    workspaceHash: string;
+    model: string;
+    promptTokens: number;
+    completionTokens: number;
+    requests: number;
+    estimatedCost: number;
+};
+export type UsageReport = {
+    period: string;
+    requests: number;
+    promptTokens: number;
+    completionTokens: number;
+    estimatedCost: number;
+};
+export type CloudSyncConfig = {
+    enabled: boolean;
+    updatedAt: string;
+};
+export type WorkspaceStatus = {
+    workspacePath: string;
+    mode: AgentMode;
+    executionMode: ExecutionMode;
+    pendingPatchCount: number;
+    unresolvedApprovals: number;
+    lastActionAt?: string;
+    lastSummary?: string;
+    repoProfile?: RepoProfile;
+    repoIndexFreshAt?: string;
+    nextSuggestedTarget?: string;
+};

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/usage.d.ts

@@ -0,0 +1,3 @@
+import type { UsageReport } from "./types.js";
+export declare function appendUsage(workspacePath: string, model: string, promptTokens: number, completionTokens: number, estimatedCost: number): Promise<void>;
+export declare function getUsageReport(period?: string): Promise<UsageReport>;

package/dist/usage.js

@@ -0,0 +1,41 @@
+import path from "node:path";
+import { readJsonFile, writeJsonFile } from "./workspace-data.js";
+import { usageDir } from "./config.js";
+import { workspaceHash } from "./workspace-data.js";
+function usageFile(period) {
+    return path.join(usageDir(), `monthly-${period}.json`);
+}
+function currentPeriod() {
+    const now = new Date();
+    const yyyy = now.getFullYear();
+    const mm = `${now.getMonth() + 1}`.padStart(2, "0");
+    return `${yyyy}-${mm}`;
+}
+function sum(entries) {
+    return {
+        period: entries[0]?.timestamp.slice(0, 7) ?? currentPeriod(),
+        requests: entries.reduce((n, e) => n + e.requests, 0),
+        promptTokens: entries.reduce((n, e) => n + e.promptTokens, 0),
+        completionTokens: entries.reduce((n, e) => n + e.completionTokens, 0),
+        estimatedCost: Number(entries.reduce((n, e) => n + e.estimatedCost, 0).toFixed(6))
+    };
+}
+export async function appendUsage(workspacePath, model, promptTokens, completionTokens, estimatedCost) {
+    const period = currentPeriod();
+    const file = usageFile(period);
+    const entries = await readJsonFile(file, []);
+    entries.push({
+        timestamp: new Date().toISOString(),
+        workspaceHash: workspaceHash(workspacePath),
+        model,
+        promptTokens: Math.max(0, promptTokens),
+        completionTokens: Math.max(0, completionTokens),
+        requests: 1,
+        estimatedCost: Math.max(0, estimatedCost)
+    });
+    await writeJsonFile(file, entries);
+}
+export async function getUsageReport(period = currentPeriod()) {
+    const entries = await readJsonFile(usageFile(period), []);
+    return sum(entries);
+}

package/dist/workspace-data.d.ts

@@ -0,0 +1,8 @@
+export declare function workspaceHash(workspacePath: string): string;
+export declare function workspaceDataDir(workspacePath: string): string;
+export declare function workspaceSubdir(workspacePath: string, name: string): string;
+export declare function workspaceDataFile(workspacePath: string, name: string): string;
+export declare function ensureWorkspaceDataDirs(workspacePath: string): Promise<void>;
+export declare function readJsonFile<T>(filePath: string, fallback: T): Promise<T>;
+export declare function writeJsonFile(filePath: string, value: unknown): Promise<void>;
+export declare function listJsonFiles(dirPath: string): Promise<string[]>;

package/dist/workspace-data.js

@@ -0,0 +1,45 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { createHash } from "node:crypto";
+import { terryHomeDir } from "./config.js";
+export function workspaceHash(workspacePath) {
+    return createHash("sha256").update(path.resolve(workspacePath)).digest("hex").slice(0, 16);
+}
+export function workspaceDataDir(workspacePath) {
+    return path.join(terryHomeDir(), "workspaces", workspaceHash(workspacePath));
+}
+export function workspaceSubdir(workspacePath, name) {
+    return path.join(workspaceDataDir(workspacePath), name);
+}
+export function workspaceDataFile(workspacePath, name) {
+    return path.join(workspaceDataDir(workspacePath), name);
+}
+export async function ensureWorkspaceDataDirs(workspacePath) {
+    const base = workspaceDataDir(workspacePath);
+    await fs.mkdir(base, { recursive: true });
+    await fs.mkdir(path.join(base, "pending-patches"), { recursive: true });
+    await fs.mkdir(path.join(base, "sessions"), { recursive: true });
+    await fs.mkdir(path.join(base, "templates"), { recursive: true });
+}
+export async function readJsonFile(filePath, fallback) {
+    try {
+        const raw = await fs.readFile(filePath, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return fallback;
+    }
+}
+export async function writeJsonFile(filePath, value) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, JSON.stringify(value, null, 2), "utf8");
+}
+export async function listJsonFiles(dirPath) {
+    try {
+        const names = await fs.readdir(dirPath);
+        return names.filter((name) => name.endsWith(".json")).sort();
+    }
+    catch {
+        return [];
+    }
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "terry-core",
+  "version": "0.1.0",
+  "description": "Core policy, tooling, and orchestration modules for Terry Agent.",
+  "license": "MIT",
+  "author": "ELEVAREL",
+  "homepage": "https://github.com/ELEVAREL/terry-agent",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ELEVAREL/terry-agent.git",
+    "directory": "packages/terry-core"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "prepack": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "terry",
+    "agent",
+    "cli",
+    "ai",
+    "developer-tools"
+  ],
+  "dependencies": {
+    "diff": "^5.2.0",
+    "fast-glob": "^3.3.3"
+  },
+  "devDependencies": {
+    "@types/diff": "^5.2.3",
+    "@types/node": "^22.13.4",
+    "typescript": "^5.7.3"
+  }
+}