@lucern/events 0.3.0-alpha.6 → 0.3.0-alpha.8

package/dist/webhooks.js

@@ -4824,6 +4824,11 @@ var TENANT_CLIENT_INSTALLABLE_PACKAGES = [
     role: "sdk_dependency",
     directTenantImport: false
   },
+  {
+    packageName: "@lucern/graph-sync",
+    role: "host_addon_runtime",
+    directTenantImport: true
+  },
   {
     packageName: "@lucern/identity",
     role: "component_runtime",
@@ -4943,8 +4948,11 @@ function compactRecord(input) {
     Object.entries(input).filter(([, value]) => value !== void 0)
   );
 }
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
 function recordValue(value) {
-  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+  return isRecord(value) ? value : {};
 }
 var createEvidenceProjection = defineProjection({
   contractName: "create_evidence",
@@ -5650,9 +5658,16 @@ var ADD_WORKTREE = {
     },
     projectId: {
       type: "string",
-      description: "Legacy topicId alias"
+      description: "Legacy topicId alias or resolver hint"
+    },
+    topicId: {
+      type: "string",
+      description: "Optional topic scope hint for resolver validation"
+    },
+    topicHint: {
+      type: "string",
+      description: "Natural-language topic hint for automatic topic resolution"
     },
-    topicId: { type: "string", description: "Optional topic scope hint" },
     branchId: {
       type: "string",
       description: "The branch this worktree investigates"
@@ -5750,6 +5765,22 @@ var ADD_WORKTREE = {
       type: "string",
       description: "Optional domain pack whose shaping hooks should influence generated questions and tasks"
     },
+    tags: {
+      type: "array",
+      description: "Additional topic-resolution tags for the worktree"
+    },
+    touchedPaths: {
+      type: "array",
+      description: "File paths used as topic-resolution signals"
+    },
+    sourceRef: {
+      type: "string",
+      description: "Source reference used as a topic-resolution signal"
+    },
+    sourceKind: {
+      type: "string",
+      description: "Source kind used as a topic-resolution signal"
+    },
     campaign: {
       type: "number",
       description: "Top-level pipeline campaign number. Campaigns define the outer execution slice."
@@ -5787,7 +5818,7 @@ var ADD_WORKTREE = {
       description: "Timestamp when worktree metadata was last reconciled"
     }
   },
-  required: ["title", "topicId"],
+  required: ["title"],
   response: {
     description: "The created worktree",
     fields: {
@@ -7284,15 +7315,15 @@ var IDENTITY_WHOAMI = {
 };
 var COMPILE_CONTEXT = {
   name: "compile_context",
-  description: "Compile a focused reasoning context for a topic. Like `git log --graph --decorate` for the reasoning substrate \u2014 returns the canonical Pillar 3 context pack through the public API shape.",
+  description: "Compile a focused reasoning context. If topicId is omitted, Lucern resolves the best topic from the query. Like `git log --graph --decorate` for the reasoning substrate \u2014 returns the canonical Pillar 3 context pack through the public API shape.",
   parameters: {
     topicId: {
       type: "string",
-      description: "Topic scope ID to compile"
+      description: "Optional topic scope ID. Omit to resolve the topic from query."
     },
     query: {
       type: "string",
-      description: "Optional focus query used to rank context items"
+      description: "Focus query used to resolve the topic and rank context items. Required when topicId is omitted."
     },
     budget: {
       type: "number",
@@ -7316,7 +7347,7 @@ var COMPILE_CONTEXT = {
       description: "Include related ontological entities in the compiled result"
     }
   },
-  required: ["topicId"],
+  required: [],
   response: {
     description: "Compiled context pack for the requested topic",
     fields: {
@@ -7490,18 +7521,60 @@ var CREATE_TASK = {
   name: "create_task",
   description: "Create an execution task tied to the reasoning state. Like `git task` \u2014 tracks concrete work items (calls to make, data to gather, analyses to run) linked to questions, beliefs, or worktrees.",
   parameters: {
-    title: { type: "string", description: "Task description" },
+    title: { type: "string", description: "Task title" },
     topicId: { type: "string", description: "Topic scope" },
+    description: {
+      type: "string",
+      description: "Long-form task description"
+    },
     taskType: {
       type: "string",
-      description: "Type: research, interview, analysis, data_collection",
-      enum: ["research", "interview", "analysis", "data_collection"]
+      description: "Task taxonomy",
+      enum: [
+        "general",
+        "find_evidence",
+        "verify_claim",
+        "research",
+        "review",
+        "interview",
+        "analysis",
+        "track_metrics"
+      ]
+    },
+    priority: {
+      type: "string",
+      description: "Priority",
+      enum: ["urgent", "high", "medium", "low"]
+    },
+    status: {
+      type: "string",
+      description: "Initial status (defaults to todo)",
+      enum: ["todo", "in_progress", "blocked", "done"]
+    },
+    linkedWorktreeId: {
+      type: "string",
+      description: "Worktree this task belongs to"
+    },
+    linkedBeliefId: {
+      type: "string",
+      description: "Belief this task supports"
     },
     linkedQuestionId: {
       type: "string",
       description: "Question this task addresses"
     },
-    linkedWorktreeId: { type: "string", description: "Worktree scope" }
+    assigneeId: {
+      type: "string",
+      description: "Principal assigned to the task"
+    },
+    dueDate: {
+      type: "number",
+      description: "Due date as epoch milliseconds"
+    },
+    tags: {
+      type: "array",
+      description: "Free-form string tags"
+    }
   },
   required: ["title"],
   response: {
@@ -9584,9 +9657,7 @@ function mcpContractFromArgsSchema(base, args, contractName) {
     required: converted.filter(([, field]) => field.required).map(([fieldName]) => fieldName)
   };
 }
-function defineFunctionContract(contract) {
-  return contract;
-}
+var defineFunctionContract = (contract) => contract;
 function authUserId(context) {
   return context.userId ?? context.principalId ?? "lucern-agent";
 }
@@ -9740,6 +9811,9 @@ var observationContextArgs = z.object({
   limit: z.number().optional().describe("Maximum observations to return."),
   status: z.string().optional().describe("Observation status filter.")
 });
+function isRecord2(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
 var observationInput = (input, context) => withUserId(
   compactRecord4({
     projectId: input.projectId,
@@ -9772,7 +9846,7 @@ var contextContracts = [
     path: "/context/compile",
     sdkNamespace: "context",
     sdkMethod: "compileContext",
-    summary: "Compile a focused reasoning context for a topic.",
+    summary: "Compile a focused reasoning context, resolving topic from query when omitted.",
     convex: {
       module: "contextCompiler",
       functionName: "compile",
@@ -9794,8 +9868,8 @@ var contextContracts = [
       kind: "mutation",
       inputProjection: observationInput,
       outputProjection: (output, input) => ({
-        ...output && typeof output === "object" ? output : {},
-        observationId: output && typeof output === "object" ? output.nodeId : void 0,
+        ...isRecord2(output) ? output : {},
+        observationId: isRecord2(output) ? output.nodeId : void 0,
         observationType: input.observationType
       })
     },
@@ -11276,10 +11350,11 @@ var worktreeDecisionGateInputSchema = z.object({
   decidedBy: z.string().optional().describe("Actor that decided the gate verdict.")
 }).passthrough().describe("Decision gate contract for worktree activation or exit.");
 var addWorktreeArgs = z.object({
-  title: z.string().optional().describe("Human-readable worktree name or objective."),
+  title: z.string().describe("Human-readable worktree name or objective."),
   name: z.string().optional().describe("Storage-name alias for callers that already use backend naming."),
-  topicId: z.string().describe("Primary topic scope for the worktree."),
-  projectId: z.string().optional().describe("Legacy topicId alias."),
+  topicId: z.string().optional().describe("Optional primary topic scope hint for resolver validation."),
+  projectId: z.string().optional().describe("Legacy topicId alias/hint."),
+  topicHint: z.string().optional().describe("Natural-language topic hint for automatic topic resolution."),
   branchId: z.string().optional().describe("Legacy branch identifier for compatibility with workflow callers."),
   objective: z.string().optional().describe("Reasoning objective this worktree is intended to resolve."),
   hypothesis: z.string().optional().describe("Testable claim this worktree investigates."),
@@ -11304,6 +11379,10 @@ var addWorktreeArgs = z.object({
   autoShape: z.boolean().optional().describe("Whether to invoke inquiry auto-shaping during creation."),
   autoFixPolicy: autoFixPolicyInputSchema.optional(),
   domainPackId: z.string().optional().describe("Domain pack whose shaping hooks should influence the worktree."),
+  tags: z.array(z.string()).optional().describe("Additional topic-resolution tags for the worktree."),
+  touchedPaths: z.array(z.string()).optional().describe("File paths used as topic-resolution signals."),
+  sourceRef: z.string().optional().describe("Source reference used as a topic-resolution signal."),
+  sourceKind: z.string().optional().describe("Source kind used as a topic-resolution signal."),
   campaign: z.number().optional().describe("Top-level pipeline campaign number."),
   lane: z.string().optional().describe("Campaign lane for the worktree."),
   laneOrderInCampaign: z.number().optional().describe("Ordering for this lane within its campaign."),
@@ -11633,8 +11712,46 @@ var worktreesContracts = [
     args: openPullRequestArgs
   })
 ];
-
-// ../contracts/src/function-registry/tasks.ts
+var taskPrioritySchema = z.enum(["urgent", "high", "medium", "low"]);
+var taskStatusSchema2 = z.enum(["todo", "in_progress", "blocked", "done"]);
+var taskTypeSchema = z.enum([
+  "general",
+  "find_evidence",
+  "verify_claim",
+  "research",
+  "review",
+  "interview",
+  "analysis",
+  "track_metrics"
+]);
+var createTaskArgs = z.object({
+  title: z.string().describe("Task title."),
+  topicId: z.string().optional().describe("Topic scope."),
+  description: z.string().optional().describe("Long-form task description."),
+  taskType: taskTypeSchema.optional().describe("Task taxonomy."),
+  priority: taskPrioritySchema.optional().describe("Priority. Defaults to medium when omitted by the server."),
+  status: taskStatusSchema2.optional().describe("Initial status. Defaults to todo."),
+  linkedWorktreeId: z.string().optional().describe("Worktree this task belongs to."),
+  linkedBeliefId: z.string().optional().describe("Belief this task supports."),
+  linkedQuestionId: z.string().optional().describe("Question this task addresses."),
+  assigneeId: z.string().optional().describe("Principal assigned to the task."),
+  dueDate: z.number().optional().describe("Due date as epoch milliseconds."),
+  tags: z.array(z.string()).optional().describe("Free-form tags.")
+});
+var createTaskInput = (input) => compactRecord4({
+  title: input.title,
+  topicId: input.topicId,
+  description: input.description,
+  taskType: input.taskType,
+  priority: input.priority ?? "medium",
+  status: input.status ?? "todo",
+  linkedWorktreeId: input.linkedWorktreeId,
+  linkedBeliefId: input.linkedBeliefId,
+  linkedQuestionId: input.linkedQuestionId,
+  assigneeId: input.assigneeId,
+  dueDate: input.dueDate,
+  tags: input.tags
+});
 var taskInput = (input) => compactRecord4({
   ...input,
   taskId: input.taskId ?? input.id
@@ -11666,8 +11783,10 @@ var tasksContracts = [
     convex: {
       module: "tasks",
       functionName: "create",
-      kind: "mutation"
-    }
+      kind: "mutation",
+      inputProjection: createTaskInput
+    },
+    args: createTaskArgs
   }),
   surfaceContract({
     name: "list_tasks",
@@ -12785,9 +12904,12 @@ var ALL_FUNCTION_CONTRACTS = [
   ...legacyContracts
 ];
 assertSurfaceCoverage(ALL_FUNCTION_CONTRACTS);
-new Map(
+var FUNCTION_CONTRACTS_BY_NAME = new Map(
   ALL_FUNCTION_CONTRACTS.map((contract) => [contract.name, contract])
 );
+FUNCTION_CONTRACTS_BY_NAME.get.bind(
+  FUNCTION_CONTRACTS_BY_NAME
+);
 
 // ../contracts/src/tenant-bootstrap-seed.contract.ts
 function isCopyableSeedRequirement(entry) {
@@ -13389,11 +13511,16 @@ TENANT_BOOTSTRAP_TABLE_REQUIREMENTS.filter(
 
 // src/webhooks.ts
 var LOCALHOST_HOSTS = /* @__PURE__ */ new Set(["localhost", "127.0.0.1", "::1"]);
+function invalidWebhookUrlError(error) {
+  return new Error("Webhook URL must be a valid absolute URL.", {
+    cause: error
+  });
+}
 function normalizeUrl(url) {
   try {
     return new URL(url.trim());
-  } catch {
-    throw new Error("Webhook URL must be a valid absolute URL.");
+  } catch (error) {
+    throw invalidWebhookUrlError(error);
   }
 }
 function assertValidWebhookUrl(url) {