fuli-context 0.7.4-beta.3 → 0.7.6

package/src/graphiti/provider-client.js

@@ -79,6 +79,281 @@ export class GraphitiProviderClient {
       `/v1/personal-projects/${encodeURIComponent(projectId)}?${query}`
     );
   }
+  upsertProjectAgent(input) {
+    return this.#request('/v1/project-agents', { method: 'PUT', body: input });
+  }
+  listProjectAgents(
+    personalSpaceId,
+    personalProjectId = null,
+    { status = null, capability = null } = {}
+  ) {
+    const query = new URLSearchParams({
+      personal_space_id: personalSpaceId
+    });
+    if (personalProjectId) query.set('personal_project_id', personalProjectId);
+    if (status) query.set('status', status);
+    if (capability) query.set('capability', capability);
+    return this.#request(`/v1/project-agents?${query}`);
+  }
+  getProjectAgent(personalSpaceId, personalProjectId, agentId) {
+    const query = new URLSearchParams({ personal_space_id: personalSpaceId });
+    if (personalProjectId) query.set('personal_project_id', personalProjectId);
+    return this.#request(
+      `/v1/project-agents/${encodeURIComponent(agentId)}?${query}`
+    );
+  }
+  deleteProjectAgent(personalSpaceId, agentId, reason = 'archived by user') {
+    const query = new URLSearchParams({
+      personal_space_id: personalSpaceId,
+      reason
+    });
+    return this.#request(
+      `/v1/project-agents/${encodeURIComponent(agentId)}?${query}`,
+      { method: 'DELETE' }
+    );
+  }
+  cleanupProjectAgentTestRoles(personalSpaceId, testSource) {
+    const query = new URLSearchParams({
+      personal_space_id: personalSpaceId,
+      test_source: testSource
+    });
+    return this.#request(`/v1/project-agents/test-cleanup?${query}`, {
+      method: 'POST'
+    });
+  }
+  createProjectAgentAssignment(input) {
+    return this.#request('/v1/project-agent-assignments', {
+      method: 'POST', body: input
+    });
+  }
+  listProjectAgentAssignments({
+    personalSpaceId,
+    personalProjectId = null,
+    agentId = null,
+    status = null
+  }) {
+    const query = new URLSearchParams({ personal_space_id: personalSpaceId });
+    if (personalProjectId) query.set('personal_project_id', personalProjectId);
+    if (agentId) query.set('agent_id', agentId);
+    if (status) query.set('status', status);
+    return this.#request(`/v1/project-agent-assignments?${query}`);
+  }
+  endProjectAgentAssignment(input) {
+    return this.#request('/v1/project-agent-assignments/end', {
+      method: 'POST', body: input
+    });
+  }
+  replaceProjectAgentAssignment(input) {
+    return this.#request('/v1/project-agent-assignments/replace', {
+      method: 'POST', body: input
+    });
+  }
+  submitProjectAgentTask(input) {
+    return this.#request('/v1/project-agent-tasks', {
+      method: 'POST', body: input
+    });
+  }
+  listProjectAgentTasks({
+    personalSpaceId,
+    personalProjectId = null,
+    agentId = null,
+    status = null,
+    limit = null
+  }) {
+    const query = new URLSearchParams({
+      personal_space_id: personalSpaceId
+    });
+    if (personalProjectId) query.set('personal_project_id', personalProjectId);
+    if (agentId) query.set('agent_id', agentId);
+    if (status) query.set('status', status);
+    if (limit !== null && limit !== undefined) query.set('limit', String(limit));
+    return this.#request(`/v1/project-agent-tasks?${query}`);
+  }
+  viewProjectAgentTask(personalSpaceId, taskId, { includeEvents = true } = {}) {
+    const query = new URLSearchParams({ personal_space_id: personalSpaceId });
+    query.set('include_events', String(includeEvents));
+    return this.#request(
+      `/v1/project-agent-tasks/${encodeURIComponent(taskId)}?${query}`
+    );
+  }
+  recordProjectAgentTaskActivity(input) {
+    return this.#request(
+      `/v1/project-agent-tasks/${encodeURIComponent(input.task_id ?? input.taskId)}/events`,
+      {
+        method: 'POST', body: input
+      }
+    );
+  }
+  listProjectAgentActivity({
+    personalSpaceId,
+    agentId,
+    fromDate = null,
+    toDate = null
+  }) {
+    const today = new Date().toISOString().slice(0, 10);
+    const query = new URLSearchParams({
+      personal_space_id: personalSpaceId,
+      from: fromDate ?? toDate ?? today,
+      to: toDate ?? fromDate ?? today
+    });
+    return this.#request(
+      `/v1/project-agents/${encodeURIComponent(agentId)}/activity?${query}`
+    );
+  }
+  getProjectAgentCoordinationPolicy(personalSpaceId, personalProjectId) {
+    const query = new URLSearchParams({
+      personal_space_id: personalSpaceId,
+      personal_project_id: personalProjectId
+    });
+    return this.#request(`/v1/project-agent-coordination-policy?${query}`);
+  }
+  updateProjectAgentCoordinationPolicy(input) {
+    return this.#request('/v1/project-agent-coordination-policy', {
+      method: 'PUT', body: input
+    });
+  }
+  getProjectAgentRecruitmentPolicy(personalSpaceId) {
+    const query = new URLSearchParams({ personal_space_id: personalSpaceId });
+    return this.#request(`/v1/project-agent-recruitment-policy?${query}`);
+  }
+  updateProjectAgentRecruitmentPolicy(input) {
+    return this.#request('/v1/project-agent-recruitment-policy', {
+      method: 'PUT', body: input
+    });
+  }
+  listProjectAgentRecruitments({
+    personalSpaceId,
+    personalProjectId = null,
+    taskId = null,
+    status = null
+  }) {
+    const query = new URLSearchParams({ personal_space_id: personalSpaceId });
+    if (personalProjectId) query.set('personal_project_id', personalProjectId);
+    if (taskId) query.set('task_id', taskId);
+    if (status) query.set('status', status);
+    return this.#request(`/v1/project-agent-recruitments?${query}`);
+  }
+  decideProjectAgentRecruitment(input) {
+    return this.#request(
+      `/v1/project-agent-recruitments/${encodeURIComponent(
+        input.recruitment_id ?? input.recruitmentId
+      )}/decision`,
+      { method: 'POST', body: input }
+    );
+  }
+  upsertExecutor(input) {
+    return this.#request('/v1/executors', { method: 'PUT', body: input });
+  }
+  listExecutors(
+    personalSpaceId,
+    { capability = null, availableOnly = false } = {}
+  ) {
+    const query = new URLSearchParams({ personal_space_id: personalSpaceId });
+    if (capability) query.set('capability', capability);
+    if (availableOnly) query.set('available_only', 'true');
+    return this.#request(`/v1/executors?${query}`);
+  }
+  getExecutor(personalSpaceId, executorId) {
+    const query = new URLSearchParams({ personal_space_id: personalSpaceId });
+    return this.#request(`/v1/executors/${encodeURIComponent(executorId)}?${query}`);
+  }
+  deleteExecutor(personalSpaceId, executorId) {
+    const query = new URLSearchParams({ personal_space_id: personalSpaceId });
+    return this.#request(`/v1/executors/${encodeURIComponent(executorId)}?${query}`, {
+      method: 'DELETE'
+    });
+  }
+  preflightExecutor(input) {
+    return this.#request('/v1/executors/preflight', { method: 'POST', body: input });
+  }
+  authorizeExecutor(input) {
+    return this.#request('/v1/executors/authorization', {
+      method: 'POST', body: input
+    });
+  }
+  reportExecutorHealth(input) {
+    return this.#request('/v1/executors/health', {
+      method: 'POST', body: input
+    });
+  }
+  recordProjectAgentExecutorActual(input) {
+    return this.#request('/v1/project-agent-executor-actuals', {
+      method: 'POST', body: input
+    });
+  }
+  upsertExecutorRoutingRule(input) {
+    return this.#request('/v1/executor-routing-rules', {
+      method: 'PUT', body: input
+    });
+  }
+  updateExecutorRoutingRule(input) {
+    return this.#request(
+      `/v1/executor-routing-rules/${encodeURIComponent(
+        input.rule_id ?? input.ruleId
+      )}`,
+      { method: 'PATCH', body: input }
+    );
+  }
+  listExecutorRoutingRules({
+    personalSpaceId,
+    scope = null,
+    personalProjectId = null,
+    taskId = null,
+    status = null,
+    enabled = null
+  }) {
+    const query = new URLSearchParams({ personal_space_id: personalSpaceId });
+    if (scope) query.set('scope', scope);
+    if (personalProjectId) query.set('personal_project_id', personalProjectId);
+    if (taskId) query.set('task_id', taskId);
+    if (status) query.set('status', status);
+    else if (enabled !== null && enabled !== undefined) {
+      query.set('status', enabled ? 'active' : 'disabled');
+    }
+    return this.#request(`/v1/executor-routing-rules?${query}`);
+  }
+  getExecutorRoutingRule(personalSpaceId, ruleId) {
+    const query = new URLSearchParams({ personal_space_id: personalSpaceId });
+    return this.#request(
+      `/v1/executor-routing-rules/${encodeURIComponent(ruleId)}?${query}`
+    );
+  }
+  deleteExecutorRoutingRule(personalSpaceId, ruleId) {
+    const query = new URLSearchParams({ personal_space_id: personalSpaceId });
+    return this.#request(
+      `/v1/executor-routing-rules/${encodeURIComponent(ruleId)}?${query}`,
+      { method: 'DELETE' }
+    );
+  }
+  recordProjectAgentTaskOutcome(input) {
+    return this.#request('/v1/project-agent-routing-outcomes', {
+      method: 'POST', body: input
+    });
+  }
+  listProjectAgentRoutingLearning({
+    personalSpaceId,
+    personalProjectId = null,
+    workKind = null,
+    agentId = null,
+    executorId = null
+  }) {
+    const query = new URLSearchParams({ personal_space_id: personalSpaceId });
+    if (personalProjectId) query.set('personal_project_id', personalProjectId);
+    if (workKind) query.set('work_kind', workKind);
+    if (agentId) query.set('agent_id', agentId);
+    if (executorId) query.set('executor_id', executorId);
+    return this.#request(`/v1/project-agent-routing-learning?${query}`);
+  }
+  ignoreProjectAgentRoutingLearning(input) {
+    return this.#request('/v1/project-agent-routing-learning/ignore', {
+      method: 'POST', body: input
+    });
+  }
+  resetProjectAgentRoutingLearning(input) {
+    return this.#request('/v1/project-agent-routing-learning/reset', {
+      method: 'POST', body: input
+    });
+  }
   createPublicationDraft(input) {
     return this.#request('/v1/publication-drafts', { method: 'POST', body: input });
   }
@@ -320,12 +595,18 @@ export class GraphitiProviderClient {
     );
   }
   search(input) { return this.#request('/v1/search', { method: 'POST', body: input }); }
-  collaborationPreferences(personalSpaceId, personalProjectId = null, limit = 100) {
+  collaborationPreferences(
+    personalSpaceId,
+    personalProjectId = null,
+    limit = 100,
+    projectAgentId = null
+  ) {
     const query = new URLSearchParams({
       personal_space_id: personalSpaceId,
       limit: String(limit)
     });
     if (personalProjectId) query.set('personal_project_id', personalProjectId);
+    if (projectAgentId) query.set('project_agent_id', projectAgentId);
     return this.#request(`/v1/collaboration-preferences?${query}`);
   }
   graph(spaceId, limit = 500, personalProjectId = null, offset = null) {

package/src/http/api-router.js

@@ -36,13 +36,67 @@ export async function handleApiRequest({
     return true;
   }
 
-  if (await handleExternalKnowledgeApiRequest({
-    request,
-    response,
-    url,
-    externalKnowledge,
-    connectedKnowledge
-  })) return true;
-
-  return handleGraphApiRequest({ request, response, url, app });
+  if (system && url.pathname === '/api/system/runtime' && request.method === 'GET') {
+    sendJson(response, 200, system.runtimeStatus());
+    return true;
+  }
+
+  if (system && url.pathname === '/api/system/runtime/leases' && request.method === 'POST') {
+    sendJson(response, 201, await system.acquireRuntimeLease(await readJson(request)));
+    return true;
+  }
+
+  const runtimeLease = url.pathname.match(/^\/api\/system\/runtime\/leases\/([^/]+)$/);
+  if (system && runtimeLease && request.method === 'PATCH') {
+    sendJson(
+      response,
+      200,
+      system.refreshRuntimeLease(decodeURIComponent(runtimeLease[1]))
+    );
+    return true;
+  }
+  if (system && runtimeLease && request.method === 'DELETE') {
+    sendJson(
+      response,
+      200,
+      system.releaseRuntimeLease(decodeURIComponent(runtimeLease[1]))
+    );
+    return true;
+  }
+
+  const externalRequest = () => handleExternalKnowledgeApiRequest({
+    request, response, url, externalKnowledge, connectedKnowledge
+  });
+  const handledExternal = system?.withGraphRuntimeLease &&
+    externalRequestNeedsGraph(url.pathname, request.method)
+    ? await system.withGraphRuntimeLease(
+        `http:${request.method}:${url.pathname}`,
+        externalRequest
+      )
+    : await externalRequest();
+  if (handledExternal) return true;
+
+  const graphRequest = () => handleGraphApiRequest({ request, response, url, app });
+  if (system?.withGraphRuntimeLease && url.pathname.startsWith('/api/')) {
+    return system.withGraphRuntimeLease(
+      `http:${request.method}:${url.pathname}`,
+      graphRequest
+    );
+  }
+  return graphRequest();
+}
+
+function externalRequestNeedsGraph(pathname, method) {
+  if (pathname === '/api/connected-knowledge/search' && method === 'POST') return true;
+  if (pathname === '/api/external-knowledge/bindings' && method === 'POST') return true;
+  if (
+    /^\/api\/external-knowledge\/bindings\/[^/]+\/sync$/.test(pathname) &&
+    method === 'POST'
+  ) return true;
+  if (
+    /^\/api\/external-knowledge\/bindings\/[^/]+\/targets$/.test(pathname) &&
+    method === 'PATCH'
+  ) return true;
+  return /^\/api\/external-knowledge\/bindings\/[^/]+$/.test(pathname) &&
+    method === 'DELETE';
 }

package/src/http/graph-api-router.js

@@ -178,6 +178,296 @@ export async function handleGraphApiRequest({
     sendJson(response, 200, await app.upsertPersonalProject(await readJson(request)));
     return true;
   }
+  if (url.pathname === '/api/project-agents' && request.method === 'GET') {
+    sendJson(response, 200, await app.listProjectAgents({
+      personalSpaceId: url.searchParams.get('personalSpaceId'),
+      personalProjectId: url.searchParams.get('personalProjectId'),
+      status: url.searchParams.get('status'),
+      capability: url.searchParams.get('capability')
+    }));
+    return true;
+  }
+  if (url.pathname === '/api/project-agents' && request.method === 'PUT') {
+    sendJson(response, 200, await app.upsertProjectAgent(await readJson(request)));
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-context' && request.method === 'POST') {
+    sendJson(response, 200, await app.getProjectAgentContext(await readJson(request)));
+    return true;
+  }
+  const projectAgentPath = url.pathname.match(/^\/api\/project-agents\/([^/]+)$/);
+  if (projectAgentPath && request.method === 'GET') {
+    sendJson(response, 200, await app.getProjectAgent({
+      personalSpaceId: url.searchParams.get('personalSpaceId'),
+      personalProjectId: url.searchParams.get('personalProjectId'),
+      agentId: decodeURIComponent(projectAgentPath[1])
+    }));
+    return true;
+  }
+  if (projectAgentPath && request.method === 'DELETE') {
+    sendJson(response, 200, await app.deleteProjectAgent({
+      personalSpaceId: url.searchParams.get('personalSpaceId'),
+      agentId: decodeURIComponent(projectAgentPath[1]),
+      reason: url.searchParams.get('reason') ?? 'archived by user'
+    }));
+    return true;
+  }
+  if (url.pathname === '/api/project-agents/test-cleanup' && request.method === 'POST') {
+    sendJson(response, 200, await app.cleanupProjectAgentTestRoles({
+      personalSpaceId: url.searchParams.get('personalSpaceId'),
+      testSource: url.searchParams.get('testSource')
+    }));
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-assignments' && request.method === 'GET') {
+    sendJson(response, 200, await app.listProjectAgentAssignments({
+      personalSpaceId: url.searchParams.get('personalSpaceId'),
+      personalProjectId: url.searchParams.get('personalProjectId'),
+      agentId: url.searchParams.get('agentId'),
+      status: url.searchParams.get('status')
+    }));
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-assignments' && request.method === 'POST') {
+    sendJson(response, 200, await app.createProjectAgentAssignment(await readJson(request)));
+    return true;
+  }
+  const projectAgentAssignmentPath = url.pathname.match(
+    /^\/api\/project-agent-assignments\/([^/]+)\/(end|replace)$/
+  );
+  if (projectAgentAssignmentPath && request.method === 'POST') {
+    const body = await readJson(request);
+    const input = {
+      ...body,
+      assignmentId: decodeURIComponent(projectAgentAssignmentPath[1])
+    };
+    const result = projectAgentAssignmentPath[2] === 'end'
+      ? await app.endProjectAgentAssignment(input)
+      : await app.replaceProjectAgentAssignment(input);
+    sendJson(response, 200, result);
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-tasks' && request.method === 'GET') {
+    sendJson(response, 200, await app.listProjectAgentTasks({
+      personalSpaceId: url.searchParams.get('personalSpaceId'),
+      personalProjectId: url.searchParams.get('personalProjectId'),
+      agentId: url.searchParams.get('agentId'),
+      status: url.searchParams.get('status'),
+      limit: numberParam(url, 'limit', null)
+    }));
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-tasks' && request.method === 'POST') {
+    sendJson(response, 200, await app.submitProjectAgentTask(await readJson(request)));
+    return true;
+  }
+  const projectAgentTaskPath = url.pathname.match(/^\/api\/project-agent-tasks\/([^/]+)$/);
+  if (projectAgentTaskPath && request.method === 'GET') {
+    sendJson(response, 200, await app.viewProjectAgentTask({
+      personalSpaceId: url.searchParams.get('personalSpaceId'),
+      taskId: decodeURIComponent(projectAgentTaskPath[1]),
+      includeEvents: url.searchParams.get('includeEvents') !== 'false'
+    }));
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-activity' && request.method === 'GET') {
+    sendJson(response, 200, await app.viewProjectAgentActivity({
+      personalSpaceId: url.searchParams.get('personalSpaceId'),
+      agentId: url.searchParams.get('agentId'),
+      fromDate: url.searchParams.get('fromDate'),
+      toDate: url.searchParams.get('toDate')
+    }));
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-activity' && request.method === 'POST') {
+    sendJson(response, 200, await app.recordProjectAgentTaskActivity(await readJson(request)));
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-coordination-policy' && request.method === 'GET') {
+    sendJson(response, 200, await app.getProjectAgentCoordinationPolicy({
+      personalSpaceId: url.searchParams.get('personalSpaceId'),
+      personalProjectId: url.searchParams.get('personalProjectId')
+    }));
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-coordination-policy' &&
+      (request.method === 'PUT' || request.method === 'PATCH')) {
+    sendJson(response, 200, await app.updateProjectAgentCoordinationPolicy(await readJson(request)));
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-recruitment-policy' && request.method === 'GET') {
+    sendJson(response, 200, await app.getProjectAgentRecruitmentPolicy({
+      personalSpaceId: url.searchParams.get('personalSpaceId')
+    }));
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-recruitment-policy' &&
+      (request.method === 'PUT' || request.method === 'PATCH')) {
+    sendJson(response, 200, await app.updateProjectAgentRecruitmentPolicy(await readJson(request)));
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-recruitments' && request.method === 'GET') {
+    sendJson(response, 200, await app.listProjectAgentRecruitments({
+      personalSpaceId: url.searchParams.get('personalSpaceId'),
+      personalProjectId: url.searchParams.get('personalProjectId'),
+      taskId: url.searchParams.get('taskId'),
+      status: url.searchParams.get('status')
+    }));
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-recruitments/decision' && request.method === 'POST') {
+    sendJson(response, 200, await app.decideProjectAgentRecruitment(await readJson(request)));
+    return true;
+  }
+  if (url.pathname === '/api/executors' && request.method === 'GET') {
+    sendJson(response, 200, await app.listExecutors({
+      personalSpaceId: url.searchParams.get('personalSpaceId'),
+      capability: url.searchParams.get('capability'),
+      availableOnly: url.searchParams.get('availableOnly') === 'true'
+    }));
+    return true;
+  }
+  if (url.pathname === '/api/executors' && request.method === 'PUT') {
+    sendJson(response, 200, await app.upsertExecutor(await readJson(request)));
+    return true;
+  }
+  const executorPath = url.pathname.match(/^\/api\/executors\/([^/]+)$/);
+  if (executorPath && request.method === 'GET') {
+    sendJson(response, 200, await app.getExecutor({
+      personalSpaceId: url.searchParams.get('personalSpaceId'),
+      executorId: decodeURIComponent(executorPath[1])
+    }));
+    return true;
+  }
+  if (executorPath && request.method === 'DELETE') {
+    sendJson(response, 200, await app.deleteExecutor({
+      personalSpaceId: url.searchParams.get('personalSpaceId'),
+      executorId: decodeURIComponent(executorPath[1])
+    }));
+    return true;
+  }
+  if (url.pathname === '/api/executors/preflight' && request.method === 'POST') {
+    sendJson(response, 200, await app.preflightExecutor(await readJson(request)));
+    return true;
+  }
+  if (url.pathname === '/api/executors/authorization' && request.method === 'POST') {
+    sendJson(response, 200, await app.authorizeExecutor(await readJson(request)));
+    return true;
+  }
+  if (url.pathname === '/api/executors/health' && request.method === 'POST') {
+    sendJson(response, 200, await app.reportExecutorHealth(await readJson(request)));
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-executor-actuals' && request.method === 'POST') {
+    sendJson(response, 200, await app.recordProjectAgentExecutorActual(await readJson(request)));
+    return true;
+  }
+  if (url.pathname === '/api/executor-routing-rules' && request.method === 'GET') {
+    sendJson(response, 200, await app.listExecutorRoutingRules({
+      personalSpaceId: url.searchParams.get('personalSpaceId'),
+      scope: url.searchParams.get('scope'),
+      personalProjectId: url.searchParams.get('personalProjectId'),
+      taskId: url.searchParams.get('taskId'),
+      status: url.searchParams.get('status')
+    }));
+    return true;
+  }
+  if (url.pathname === '/api/executor-routing-rules' && request.method === 'PUT') {
+    sendJson(response, 200, await app.upsertExecutorRoutingRule(await readJson(request)));
+    return true;
+  }
+  const executorRoutingRulePath = url.pathname.match(
+    /^\/api\/executor-routing-rules\/([^/]+)$/
+  );
+  if (executorRoutingRulePath && request.method === 'GET') {
+    sendJson(response, 200, await app.getExecutorRoutingRule({
+      personalSpaceId: url.searchParams.get('personalSpaceId'),
+      ruleId: decodeURIComponent(executorRoutingRulePath[1])
+    }));
+    return true;
+  }
+  if (executorRoutingRulePath && request.method === 'PATCH') {
+    const body = await readJson(request);
+    sendJson(response, 200, await app.updateExecutorRoutingRule({
+      ...body,
+      personalSpaceId: body.personalSpaceId ?? url.searchParams.get('personalSpaceId'),
+      ruleId: decodeURIComponent(executorRoutingRulePath[1])
+    }));
+    return true;
+  }
+  if (executorRoutingRulePath && request.method === 'DELETE') {
+    sendJson(response, 200, await app.deleteExecutorRoutingRule({
+      personalSpaceId: url.searchParams.get('personalSpaceId'),
+      ruleId: decodeURIComponent(executorRoutingRulePath[1])
+    }));
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-routing-learning' && request.method === 'GET') {
+    sendJson(response, 200, await app.listProjectAgentRoutingLearning({
+      personalSpaceId: url.searchParams.get('personalSpaceId'),
+      personalProjectId: url.searchParams.get('personalProjectId'),
+      workKind: url.searchParams.get('workKind'),
+      agentId: url.searchParams.get('agentId'),
+      executorId: url.searchParams.get('executorId')
+    }));
+    return true;
+  }
+  const projectAgentLearningPath = url.pathname.match(
+    /^\/api\/project-agent-learning\/([^/]+)$/
+  );
+  if (projectAgentLearningPath && request.method === 'PATCH') {
+    const body = await readJson(request);
+    const evidenceId = decodeURIComponent(projectAgentLearningPath[1]);
+    const action = body.action;
+    if (!['ignore', 'reset'].includes(action)) {
+      throw new TypeError('Project Agent learning action must be ignore or reset');
+    }
+    const personalSpaceId = body.personalSpaceId ??
+      url.searchParams.get('personalSpaceId') ?? app.config?.personal?.spaceId;
+    const personalProjectId = body.personalProjectId ??
+      url.searchParams.get('personalProjectId');
+    const agentId = body.agentId ?? url.searchParams.get('agentId');
+    if (!personalSpaceId || !personalProjectId || !agentId) {
+      throw new TypeError(
+        'Project Agent learning updates require personalSpaceId, personalProjectId, and agentId'
+      );
+    }
+    const idempotencyKey = body.idempotencyKey ??
+      `console-learning:${evidenceId}:${action}`;
+    const reason = body.reason ?? `Console requested ${action} for explicit evidence`;
+    const input = {
+      ...body,
+      personalSpaceId,
+      personalProjectId,
+      agentId,
+      evidenceId,
+      idempotencyKey,
+      reason
+    };
+    if (action === 'ignore') {
+      sendJson(response, 200, await app.ignoreProjectAgentRoutingLearning(input));
+      return true;
+    }
+    if (!input.workKind || !input.executorId || !input.resetAt) {
+      throw new TypeError(
+        'Project Agent learning reset requires workKind, executorId, and resetAt'
+      );
+    }
+    sendJson(response, 200, await app.resetProjectAgentRoutingLearning(input));
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-routing-learning/ignore' && request.method === 'POST') {
+    sendJson(response, 200, await app.ignoreProjectAgentRoutingLearning(await readJson(request)));
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-routing-learning/reset' && request.method === 'POST') {
+    sendJson(response, 200, await app.resetProjectAgentRoutingLearning(await readJson(request)));
+    return true;
+  }
+  if (url.pathname === '/api/project-agent-routing-outcomes' && request.method === 'POST') {
+    sendJson(response, 200, await app.recordProjectAgentTaskOutcome(await readJson(request)));
+    return true;
+  }
   if (url.pathname === '/api/projects/publish' && request.method === 'POST') {
     sendJson(response, 200, await app.publishPersonalProject(await readJson(request)));
     return true;