@causyne/agent 1.10.21 → 1.11.0

package/src/acp/peerProfiles.js

@@ -0,0 +1,122 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { causyneHome } from '../utils/paths.js';
+const PROFILE_ID = /^[a-z0-9][a-z0-9._-]{0,63}$/;
+const ENV_NAME = /^[A-Za-z_][A-Za-z0-9_]{0,127}$/;
+const MAX_PEERS = 20;
+const MAX_ARGS = 32;
+const MAX_ARG_CHARS = 500;
+const MAX_ENV_ENTRIES = 32;
+const MAX_ENV_VALUE_CHARS = 2000;
+export function peerProfilesPath() {
+    return path.join(causyneHome(), 'peers.json');
+}
+function asStringArray(value, limit, maxChars) {
+    if (!Array.isArray(value))
+        return null;
+    if (value.length > limit)
+        return null;
+    const result = [];
+    for (const item of value) {
+        if (typeof item !== 'string')
+            return null;
+        result.push(item.slice(0, maxChars));
+    }
+    return result;
+}
+function asEnv(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return {};
+    const result = {};
+    let count = 0;
+    for (const [name, raw] of Object.entries(value)) {
+        if (count >= MAX_ENV_ENTRIES)
+            break;
+        if (!ENV_NAME.test(name))
+            continue;
+        if (typeof raw !== 'string')
+            continue;
+        result[name] = raw.slice(0, MAX_ENV_VALUE_CHARS);
+        count += 1;
+    }
+    return result;
+}
+function parseProfile(raw) {
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw))
+        return null;
+    const record = raw;
+    const id = typeof record.id === 'string' ? record.id.trim() : '';
+    if (!PROFILE_ID.test(id))
+        return null;
+    const command = typeof record.command === 'string' ? record.command.trim() : '';
+    if (!command || command.length > 500)
+        return null;
+    const args = asStringArray(record.args ?? [], MAX_ARGS, MAX_ARG_CHARS);
+    if (args === null)
+        return null;
+    let cwd = null;
+    if (typeof record.cwd === 'string' && record.cwd.trim()) {
+        const resolved = path.resolve(record.cwd.trim());
+        try {
+            if (!fs.statSync(resolved).isDirectory())
+                return null;
+            cwd = resolved;
+        }
+        catch {
+            return null;
+        }
+    }
+    const policy = record.policy === 'workspace' ? 'workspace' : 'read-only';
+    const timeoutSeconds = typeof record.timeoutSeconds === 'number' && Number.isFinite(record.timeoutSeconds)
+        ? Math.max(5, Math.min(1800, Math.round(record.timeoutSeconds)))
+        : 120;
+    const label = typeof record.label === 'string' && record.label.trim()
+        ? record.label.trim().slice(0, 100)
+        : id;
+    return { id, label, command, args, cwd, policy, timeoutSeconds, env: asEnv(record.env) };
+}
+export function loadPeerProfiles() {
+    let raw;
+    try {
+        raw = JSON.parse(fs.readFileSync(peerProfilesPath(), 'utf8'));
+    }
+    catch {
+        return [];
+    }
+    let entries;
+    if (Array.isArray(raw)) {
+        entries = raw;
+    }
+    else if (raw !== null && typeof raw === 'object' && Array.isArray(raw.peers)) {
+        entries = raw.peers;
+    }
+    else {
+        return [];
+    }
+    const profiles = [];
+    const seen = new Set();
+    for (const entry of entries) {
+        if (profiles.length >= MAX_PEERS)
+            break;
+        const profile = parseProfile(entry);
+        if (!profile || seen.has(profile.id))
+            continue;
+        seen.add(profile.id);
+        profiles.push(profile);
+    }
+    return profiles;
+}
+export function getPeerProfile(id) {
+    return loadPeerProfiles().find((profile) => profile.id === id) ?? null;
+}
+export function peerEnvironment(profile) {
+    const env = {};
+    for (const name of ['PATH', 'HOME', 'TMPDIR', 'TMP', 'TEMP', 'LANG', 'LC_ALL', 'SYSTEMROOT']) {
+        const value = process.env[name];
+        if (typeof value === 'string')
+            env[name] = value;
+    }
+    for (const [name, value] of Object.entries(profile.env))
+        env[name] = value;
+    return env;
+}

package/src/acp/peerProfiles.ts

@@ -0,0 +1,128 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { causyneHome } from '../utils/paths.js';
+
+export type PeerPolicy = 'read-only' | 'workspace';
+
+export interface PeerProfile {
+  id: string;
+  label: string;
+  command: string;
+  args: string[];
+  cwd: string | null;
+  policy: PeerPolicy;
+  timeoutSeconds: number;
+  env: Record<string, string>;
+}
+
+export interface PeerProfilesFile {
+  schemaVersion: number;
+  peers: PeerProfile[];
+}
+
+const PROFILE_ID = /^[a-z0-9][a-z0-9._-]{0,63}$/;
+const ENV_NAME = /^[A-Za-z_][A-Za-z0-9_]{0,127}$/;
+const MAX_PEERS = 20;
+const MAX_ARGS = 32;
+const MAX_ARG_CHARS = 500;
+const MAX_ENV_ENTRIES = 32;
+const MAX_ENV_VALUE_CHARS = 2000;
+
+export function peerProfilesPath(): string {
+  return path.join(causyneHome(), 'peers.json');
+}
+
+function asStringArray(value: unknown, limit: number, maxChars: number): string[] | null {
+  if (!Array.isArray(value)) return null;
+  if (value.length > limit) return null;
+  const result: string[] = [];
+  for (const item of value) {
+    if (typeof item !== 'string') return null;
+    result.push(item.slice(0, maxChars));
+  }
+  return result;
+}
+
+function asEnv(value: unknown): Record<string, string> {
+  if (value === null || typeof value !== 'object' || Array.isArray(value)) return {};
+  const result: Record<string, string> = {};
+  let count = 0;
+  for (const [name, raw] of Object.entries(value as Record<string, unknown>)) {
+    if (count >= MAX_ENV_ENTRIES) break;
+    if (!ENV_NAME.test(name)) continue;
+    if (typeof raw !== 'string') continue;
+    result[name] = raw.slice(0, MAX_ENV_VALUE_CHARS);
+    count += 1;
+  }
+  return result;
+}
+
+function parseProfile(raw: unknown): PeerProfile | null {
+  if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) return null;
+  const record = raw as Record<string, unknown>;
+  const id = typeof record.id === 'string' ? record.id.trim() : '';
+  if (!PROFILE_ID.test(id)) return null;
+  const command = typeof record.command === 'string' ? record.command.trim() : '';
+  if (!command || command.length > 500) return null;
+  const args = asStringArray(record.args ?? [], MAX_ARGS, MAX_ARG_CHARS);
+  if (args === null) return null;
+  let cwd: string | null = null;
+  if (typeof record.cwd === 'string' && record.cwd.trim()) {
+    const resolved = path.resolve(record.cwd.trim());
+    try {
+      if (!fs.statSync(resolved).isDirectory()) return null;
+      cwd = resolved;
+    } catch {
+      return null;
+    }
+  }
+  const policy: PeerPolicy = record.policy === 'workspace' ? 'workspace' : 'read-only';
+  const timeoutSeconds = typeof record.timeoutSeconds === 'number' && Number.isFinite(record.timeoutSeconds)
+    ? Math.max(5, Math.min(1800, Math.round(record.timeoutSeconds)))
+    : 120;
+  const label = typeof record.label === 'string' && record.label.trim()
+    ? record.label.trim().slice(0, 100)
+    : id;
+  return { id, label, command, args, cwd, policy, timeoutSeconds, env: asEnv(record.env) };
+}
+
+export function loadPeerProfiles(): PeerProfile[] {
+  let raw: unknown;
+  try {
+    raw = JSON.parse(fs.readFileSync(peerProfilesPath(), 'utf8'));
+  } catch {
+    return [];
+  }
+  let entries: unknown;
+  if (Array.isArray(raw)) {
+    entries = raw;
+  } else if (raw !== null && typeof raw === 'object' && Array.isArray((raw as Record<string, unknown>).peers)) {
+    entries = (raw as Record<string, unknown>).peers;
+  } else {
+    return [];
+  }
+  const profiles: PeerProfile[] = [];
+  const seen = new Set<string>();
+  for (const entry of entries as unknown[]) {
+    if (profiles.length >= MAX_PEERS) break;
+    const profile = parseProfile(entry);
+    if (!profile || seen.has(profile.id)) continue;
+    seen.add(profile.id);
+    profiles.push(profile);
+  }
+  return profiles;
+}
+
+export function getPeerProfile(id: string): PeerProfile | null {
+  return loadPeerProfiles().find((profile) => profile.id === id) ?? null;
+}
+
+export function peerEnvironment(profile: PeerProfile): NodeJS.ProcessEnv {
+  const env: NodeJS.ProcessEnv = {};
+  for (const name of ['PATH', 'HOME', 'TMPDIR', 'TMP', 'TEMP', 'LANG', 'LC_ALL', 'SYSTEMROOT']) {
+    const value = process.env[name];
+    if (typeof value === 'string') env[name] = value;
+  }
+  for (const [name, value] of Object.entries(profile.env)) env[name] = value;
+  return env;
+}

package/src/acp/protocol.js

@@ -0,0 +1,54 @@
+/**
+ * Agent Client Protocol (ACP) types for Causyne Agent.
+ *
+ * JSON-RPC 2.0 over stdio with newline-delimited framing. The shapes here
+ * follow the published ACP schema; the agent advertises only the capabilities
+ * it actually implements.
+ */
+export const ACP_PROTOCOL_VERSION = 1;
+export const ACP_METHODS = {
+    INITIALIZE: 'initialize',
+    NEW_SESSION: 'session/new',
+    PROMPT: 'session/prompt',
+    CANCEL: 'session/cancel',
+    UPDATE: 'session/update',
+    LOAD: 'session/load',
+    LIST: 'session/list',
+    CLOSE: 'session/close',
+    SET_MODE: 'session/set_mode',
+    REQUEST_PERMISSION: 'session/request_permission',
+    READ_TEXT_FILE: 'fs/read_text_file',
+    WRITE_TEXT_FILE: 'fs/write_text_file'
+};
+export const ACP_ERROR_CODES = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+    AUTH_REQUIRED: -32000,
+    RESOURCE_NOT_FOUND: -32002,
+    REQUEST_CANCELLED: -32800
+};
+export function isJsonRpcRequest(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const record = value;
+    return record.jsonrpc === '2.0'
+        && (typeof record.id === 'string' || typeof record.id === 'number')
+        && typeof record.method === 'string';
+}
+export function isJsonRpcResponse(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const record = value;
+    return record.jsonrpc === '2.0'
+        && (typeof record.id === 'string' || typeof record.id === 'number' || record.id === null)
+        && ('result' in record || 'error' in record);
+}
+export function isJsonRpcNotification(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const record = value;
+    return record.jsonrpc === '2.0' && typeof record.method === 'string' && !('id' in record);
+}