@aliyun-es/agentic-context 0.0.0-stage → 0.1.0

package/src/payload.js

@@ -0,0 +1,116 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { NAME, LEGACY_NAME, MARKETPLACE, VERSION, platformPath } from './config.js';
+import { writePrivate } from './files.js';
+import { contextText, requestHeaders } from '../runtime/client.js';
+
+export const PACKAGE_ROOT = fileURLToPath(new URL('../', import.meta.url));
+export function shellQuote(value) {
+  return `'${value.replaceAll("'", "'\\''")}'`;
+}
+export function hookConfig(paths, agent, { platform = process.platform, execPath = process.execPath } = {}) {
+  const args = [platformPath(platform).join(paths.runtime, 'hook.js'), paths.config];
+  let invocation;
+  if (platform === 'win32' && agent === 'claude-code') {
+    invocation = { command: execPath, args };
+  } else if (platform === 'win32') {
+    // A fixed PowerShell launcher works from cmd, PowerShell and Git Bash without re-parsing paths.
+    const script = `[Console]::InputEncoding = [Console]::OutputEncoding = $OutputEncoding = [System.Text.UTF8Encoding]::new($false); & ${[execPath, ...args].map(value => `'${value.replaceAll("'", "''")}'`).join(' ')}; exit $LASTEXITCODE`;
+    invocation = { command: `powershell.exe -NoLogo -NoProfile -NonInteractive -EncodedCommand ${Buffer.from(script, 'utf16le').toString('base64')}` };
+  } else {
+    invocation = { command: [execPath, ...args].map(shellQuote).join(' ') };
+  }
+  const events = agent === 'codex' ? ['SessionStart', 'UserPromptSubmit', 'Stop'] : ['SessionStart', 'UserPromptSubmit', 'Stop', 'PreCompact'];
+  return { hooks: Object.fromEntries(events.map(event => [event, [{ hooks: [{ type: 'command', ...invocation, timeout: 15 }] }]])) };
+}
+export function mcpServer(config, agent) {
+  const base = { url: `${config.endpoint}/v1/agentic-memory/mcp` };
+  const headers = { ...requestHeaders(config), Accept: 'application/json, text/event-stream' };
+  if (agent === 'codex') return { ...base, http_headers: headers };
+  if (agent === 'hermes') return { ...base, headers };
+  if (agent === 'openclaw') return { ...base, transport: 'streamable-http', headers };
+  return { ...base, type: 'http', headers };
+}
+
+async function copyRuntime(destination) {
+  await fs.cp(path.join(PACKAGE_ROOT, 'runtime'), destination, { recursive: true });
+  await writePrivate(path.join(destination, 'package.json'), { type: 'module' });
+  const parserRoot = path.dirname(fileURLToPath(import.meta.resolve('eventsource-parser/package.json')));
+  await fs.cp(parserRoot, path.join(destination, 'node_modules/eventsource-parser'), { recursive: true });
+}
+
+export function requiredPayloadFiles(agent, paths) {
+  const skillName = paths.skillName || NAME;
+  const runtime = agent === 'openclaw' ? path.join(paths.plugin, 'runtime') : paths.runtime;
+  // Legacy releases predate automatic recall and the submission helper. Check
+  // their original entry points, not files introduced by a newer release.
+  const shared = paths.legacy ? (agent === 'hermes' ? [] : agent === 'openclaw' ? ['client.js'] : ['package.json', 'client.js']) : [
+    'package.json', 'client.js', 'mcp.js', 'recall.js', 'version.js',
+    'node_modules/eventsource-parser/package.json', 'node_modules/eventsource-parser/dist/index.js'];
+  const entrypoints = agent === 'hermes' ? (paths.legacy ? [] : ['recall-cli.js'])
+    : ['capture.js', ...(agent === 'openclaw' ? (paths.legacy ? [] : ['submission.js']) : ['hook.js'])];
+  const files = [...shared, ...entrypoints].map(file => path.join(runtime, file));
+  files.push(path.join(paths.plugin, 'skills', skillName, 'SKILL.md'));
+  if (['codex', 'claude-code'].includes(agent)) {
+    const host = agent === 'codex' ? '.codex-plugin' : '.claude-plugin';
+    files.push(...[`${host}/plugin.json`, '.mcp.json', 'hooks/hooks.json'].map(file => path.join(paths.plugin, file)),
+      path.join(paths.marketplace, agent === 'codex' ? '.agents/plugins/marketplace.json' : '.claude-plugin/marketplace.json'));
+  } else if (agent === 'openclaw') {
+    files.push(...['index.js', 'package.json', 'openclaw.plugin.json'].map(file => path.join(paths.plugin, file)));
+  } else if (agent === 'hermes') {
+    if (!paths.legacy) files.push(path.join(paths.state, 'recall-command.json'));
+    files.push(...['__init__.py', 'plugin.yaml'].map(file => path.join(paths.plugin, 'provider', file)));
+  }
+  return files;
+}
+
+export async function preparePayload(agent, paths, config) {
+  const name = paths.name || NAME;
+  const marketplaceName = paths.marketplaceName || MARKETPLACE;
+  const skillName = paths.skillName || NAME;
+  await fs.mkdir(paths.state, { recursive: true, mode: 0o700 });
+  await fs.chmod(paths.state, 0o700);
+  if (agent !== 'openclaw') await copyRuntime(paths.runtime);
+  const skill = (await fs.readFile(path.join(PACKAGE_ROOT, 'skills/agentic-context/SKILL.md'), 'utf8'))
+    + `\n## Connection\n\n${contextText(config)}\n`;
+  await writePrivate(path.join(paths.plugin, 'skills', skillName, 'SKILL.md'), skill);
+  const manifest = { name, version: VERSION, description: 'Agentic Context: memory, knowledge bases and skills', author: { name: 'Alibaba Cloud' } };
+  if (['claude-code', 'codex'].includes(agent)) {
+    const host = agent === 'codex' ? '.codex-plugin' : '.claude-plugin';
+    await writePrivate(path.join(paths.plugin, host, 'plugin.json'), {
+      ...manifest, ...(agent === 'codex' ? {
+        skills: './skills/', mcpServers: './.mcp.json',
+        interface: {
+          displayName: 'Agentic Context', shortDescription: 'Memory, knowledge bases and skills',
+          longDescription: 'Connect an existing Agentic Context workspace to recall memory, search enterprise documents and retrieve reusable skills.',
+          developerName: 'Alibaba Cloud', category: 'Productivity', capabilities: ['Read', 'Write'],
+          defaultPrompt: 'Use Agentic Context to find relevant context for my task.',
+        },
+      } : {}),
+    });
+    await writePrivate(path.join(paths.plugin, '.mcp.json'), { mcpServers: { [name]: mcpServer(config, agent) } });
+    await writePrivate(path.join(paths.plugin, 'hooks/hooks.json'), hookConfig(paths, agent));
+    const catalog = agent === 'codex'
+      ? { name: marketplaceName, interface: { displayName: 'Alibaba Cloud Agentic Context' }, plugins: [{ name, source: { source: 'local', path: `./plugins/${name}` }, policy: { installation: 'AVAILABLE', authentication: 'ON_INSTALL' }, category: 'Productivity' }] }
+      : { name: marketplaceName, owner: { name: 'Alibaba Cloud' }, plugins: [{ ...manifest, source: `./plugins/${name}` }] };
+    await writePrivate(path.join(paths.marketplace, agent === 'codex' ? '.agents/plugins/marketplace.json' : '.claude-plugin/marketplace.json'), catalog);
+  }
+  if (agent === 'openclaw') {
+    await copyRuntime(path.join(paths.plugin, 'runtime'));
+    await fs.copyFile(path.join(PACKAGE_ROOT, 'adapters/openclaw/index.js'), path.join(paths.plugin, 'index.js'));
+    await writePrivate(path.join(paths.plugin, 'package.json'), { name: '@aliyun-es/agentic-context', version: VERSION, type: 'module', openclaw: { extensions: ['./index.js'] } });
+    await writePrivate(path.join(paths.plugin, 'openclaw.plugin.json'), {
+      id: name, name: 'Agentic Context', version: VERSION, skills: ['./skills'],
+      activation: { onStartup: true },
+      cliCommands: [name, LEGACY_NAME].map(command => ({ name: command, description: 'Agentic Context memory and skill operations', hasSubcommands: true })),
+      // OpenClaw validates config during install, before the explicit plugin entry is written.
+      configSchema: { type: 'object', properties: { configPath: { type: 'string', default: paths.config } }, required: ['configPath'], additionalProperties: false },
+    });
+  }
+  if (agent === 'hermes') {
+    await fs.cp(path.join(PACKAGE_ROOT, 'adapters/hermes'), path.join(paths.plugin, 'provider'), { recursive: true });
+    await writePrivate(path.join(paths.state, 'recall-command.json'), [process.execPath, path.join(paths.runtime, 'recall-cli.js'), paths.config]);
+  }
+  return skill;
+}

package/src/redact.js

@@ -0,0 +1,37 @@
+export function createRedactor(secrets, write) {
+  const values = secrets.filter(Boolean).sort((a, b) => b.length - a.length);
+  let pending = '', bearer = false;
+  return (text, final = false) => {
+    pending += text;
+    let output = '';
+    while (pending) {
+      if (bearer) {
+        const end = pending.search(/[\s"']/);
+        if (end === -1) { pending = ''; break; }
+        pending = pending.slice(end);
+        bearer = false;
+      }
+      // Retain partial secrets between chunks; emit ordinary prompts immediately.
+      if (!final && (values.some(value => value.startsWith(pending))
+        || (pending.length <= 7 && 'bearer '.startsWith(pending.toLowerCase())))) break;
+      const secret = values.find(value => pending.startsWith(value));
+      if (secret) { output += '[REDACTED]'; pending = pending.slice(secret.length); continue; }
+      const authorization = /^Bearer\s+/i.exec(pending);
+      if (authorization) {
+        output += 'Bearer [REDACTED]';
+        pending = pending.slice(authorization[0].length);
+        bearer = true;
+        continue;
+      }
+      output += pending[0];
+      pending = pending.slice(1);
+    }
+    if (output) write(output);
+  };
+}
+
+export function redact(text, secrets) {
+  let result = '';
+  createRedactor(secrets, part => { result += part; })(text, true);
+  return result;
+}