me2lon 0.0.0-stage → 0.1.0

package/src/index.ts

@@ -0,0 +1,37 @@
+export {
+  Me2lonAgentApi,
+  idempotencyKey,
+  mutationAttemptId,
+} from "./api.js";
+export { Me2lonAgentClient, type PolicyProposalInput } from "./client.js";
+export {
+  readConfigFile,
+  resolveRuntimeConfig,
+  type RuntimeConfigOverrides,
+} from "./config.js";
+export { Me2lonApiError, Me2lonClientError } from "./errors.js";
+export {
+  assertNoForbiddenOutput,
+  projectCapabilities,
+  projectJob,
+  projectPolicy,
+  projectPolicyProposal,
+  projectPolicyUnits,
+  projectPolicyValidation,
+  safeJsonText,
+} from "./safe-output.js";
+export {
+  LOCAL_SOURCE_LIMITS,
+  SOURCE_SCHEMA_VERSION,
+  type AgentRuntimeConfig,
+  type BoundWorkspace,
+  type ConfigFileShape,
+  type DeleteChange,
+  type JsonValue,
+  type ReplaceChange,
+  type SafeToolResult,
+  type SourceChange,
+  type SourceLimits,
+  type WorkspaceSource,
+} from "./types.js";
+export { bindWorkspace, buildWorkspaceSource } from "./workspace-source.js";

package/src/presentation.ts

@@ -0,0 +1,39 @@
+import { Me2lonClientError } from "./errors.js";
+import type { SafeToolResult, JsonValue } from './types.js';
+
+export function humanOutput(value: JsonValue, depth = 0): string {
+  if (value === null) return 'none';
+  if (typeof value !== 'object') return String(value);
+  const entries = Array.isArray(value) ? value.map((item, i) => [String(i + 1), item] as const) : Object.entries(value);
+  return entries.map(([key, item]) => `${'  '.repeat(depth)}${key}: ${item !== null && typeof item === 'object' ? '\n' + humanOutput(item, depth + 1) : String(item)}`).join('\n');
+}
+
+export async function waitForJob(initial: SafeToolResult, getJob: (id: string) => Promise<SafeToolResult>, options: {
+  timeoutMs: number; signal?: AbortSignal; notify: (message: string) => void;
+  intervalMs?: number;
+}): Promise<{ result: SafeToolResult; exitCode: number }> {
+  let result = initial;
+  const id = result.id ?? result.jobId;
+  if (typeof id !== 'string') throw new Me2lonClientError("ME2LON_CLIENT_INPUT", 'The server did not return a job ID.');
+  const deadline = Date.now() + options.timeoutMs;
+  let previousProgress = "";
+  const resume = `Resume: me2lon get-job --job-id ${id} --wait`;
+  for (;;) {
+    if (result.jobStatus === 'succeeded') return { result, exitCode: 0 };
+    if (result.jobStatus === 'failed' || result.jobStatus === 'canceled') return { result, exitCode: 1 };
+    if (options.signal?.aborted) { options.notify(resume); return { result, exitCode: 130 }; }
+    if (Date.now() >= deadline) { options.notify(resume); return { result, exitCode: 124 }; }
+    if (result.jobStatus !== 'queued' && result.jobStatus !== 'running') throw new Me2lonClientError("ME2LON_CLIENT_INPUT", 'Unknown job lifecycle status.');
+    const progress = result.progress;
+    const stage = progress && typeof progress === 'object' && !Array.isArray(progress) ? progress.stage : undefined;
+    const completed = progress && typeof progress === 'object' && !Array.isArray(progress) ? progress.completedStages : undefined;
+    const message = `Job ${id}: ${result.jobStatus}${typeof stage === 'string' ? ` — ${stage}` : ''}${typeof completed === 'number' ? ` (${completed} stages completed)` : ''}`;
+    if (message !== previousProgress) { options.notify(message); previousProgress = message; }
+    await new Promise<void>((resolve) => {
+      const done = () => { clearTimeout(timer); options.signal?.removeEventListener('abort', done); resolve(); };
+      const timer = setTimeout(done, Math.min(options.intervalMs ?? 5000, deadline - Date.now()));
+      options.signal?.addEventListener('abort', done, { once: true });
+    });
+    if (!options.signal?.aborted && Date.now() < deadline) result = await getJob(id);
+  }
+}