@elizaos/plugin-personal-assistant 2.0.3-beta.5 → 2.0.3-beta.7

package/dist/lifeops/registries/workflow-step-default-pack.js

@@ -0,0 +1,315 @@
+import { z } from "zod";
+import { describeWorkflowValue } from "../service-helpers-browser.js";
+const baseStepFields = {
+  id: z.string().optional(),
+  resultKey: z.string().optional()
+};
+const createTaskStepSchema = z.object({
+  kind: z.literal("create_task"),
+  ...baseStepFields,
+  // Request body forwarded to createDefinition; full schema lives in
+  // service-normalize-task.ts and runs at intake. Registry only enforces
+  // record-shape + presence, not the full CreateLifeOpsDefinitionRequest.
+  request: z.record(z.string(), z.unknown())
+});
+const createTaskContribution = {
+  kind: "create_task",
+  describe: {
+    label: "Create task",
+    description: "Create a LifeOpsTaskDefinition; defaults ownership to the workflow's domain when omitted.",
+    provider: "app-lifeops:default"
+  },
+  paramSchema: createTaskStepSchema,
+  async execute(step, args, ctx) {
+    const typed = step;
+    const stepRequest = typed.request;
+    const created = await ctx.createDefinition({
+      ...stepRequest,
+      ownership: stepRequest.ownership ?? {
+        domain: args.definition.domain,
+        subjectType: args.definition.subjectType,
+        subjectId: args.definition.subjectId,
+        visibilityScope: args.definition.visibilityScope,
+        contextPolicy: args.definition.contextPolicy
+      }
+    });
+    return {
+      definitionId: created.definition.id,
+      title: created.definition.title,
+      reminderPlanId: created.reminderPlan?.id ?? null
+    };
+  }
+};
+const relockWebsiteAccessStepSchema = z.object({
+  kind: z.literal("relock_website_access"),
+  ...baseStepFields,
+  request: z.object({
+    groupKey: z.string().min(1)
+  })
+});
+const relockWebsiteAccessContribution = {
+  kind: "relock_website_access",
+  describe: {
+    label: "Re-lock website access group",
+    description: "Revoke any active website-access grants for the named group.",
+    provider: "app-lifeops:default"
+  },
+  paramSchema: relockWebsiteAccessStepSchema,
+  async execute(step, args, ctx) {
+    const typed = step;
+    return ctx.relockWebsiteAccessGroup(
+      typed.request.groupKey,
+      new Date(args.startedAt)
+    );
+  }
+};
+const resolveWebsiteAccessCallbackStepSchema = z.object({
+  kind: z.literal("resolve_website_access_callback"),
+  ...baseStepFields,
+  request: z.object({
+    callbackKey: z.string().min(1)
+  })
+});
+const resolveWebsiteAccessCallbackContribution = {
+  kind: "resolve_website_access_callback",
+  describe: {
+    label: "Resolve website-access callback",
+    description: "Revoke website-access grants tied to a callback key.",
+    provider: "app-lifeops:default"
+  },
+  paramSchema: resolveWebsiteAccessCallbackStepSchema,
+  async execute(step, args, ctx) {
+    const typed = step;
+    return ctx.resolveWebsiteAccessCallback(
+      typed.request.callbackKey,
+      new Date(args.startedAt)
+    );
+  }
+};
+const getCalendarFeedStepSchema = z.object({
+  kind: z.literal("get_calendar_feed"),
+  ...baseStepFields,
+  request: z.record(z.string(), z.unknown()).optional()
+});
+const getCalendarFeedContribution = {
+  kind: "get_calendar_feed",
+  describe: {
+    label: "Get calendar feed",
+    description: "Read the LifeOps calendar feed (events + suggestions) at the run instant.",
+    provider: "app-lifeops:default"
+  },
+  paramSchema: getCalendarFeedStepSchema,
+  async execute(step, args, ctx) {
+    const internalUrl = new URL("http://127.0.0.1/");
+    const request = step.request;
+    return ctx.getCalendarFeed(
+      internalUrl,
+      request ?? {},
+      new Date(args.startedAt)
+    );
+  }
+};
+const getGmailTriageStepSchema = z.object({
+  kind: z.literal("get_gmail_triage"),
+  ...baseStepFields,
+  request: z.record(z.string(), z.unknown()).optional()
+});
+const getGmailTriageContribution = {
+  kind: "get_gmail_triage",
+  describe: {
+    label: "Get Gmail triage",
+    description: "Read the Gmail triage feed (priority, drafts, unread).",
+    provider: "app-lifeops:default"
+  },
+  paramSchema: getGmailTriageStepSchema,
+  async execute(step, args, ctx) {
+    const internalUrl = new URL("http://127.0.0.1/");
+    const request = step.request;
+    return ctx.getGmailTriage(
+      internalUrl,
+      request ?? {},
+      new Date(args.startedAt)
+    );
+  }
+};
+const getGmailUnrespondedStepSchema = z.object({
+  kind: z.literal("get_gmail_unresponded"),
+  ...baseStepFields,
+  request: z.record(z.string(), z.unknown()).optional()
+});
+const getGmailUnrespondedContribution = {
+  kind: "get_gmail_unresponded",
+  describe: {
+    label: "Get unresponded Gmail thread",
+    description: "Read Gmail threads awaiting a reply older than the threshold.",
+    provider: "app-lifeops:default"
+  },
+  paramSchema: getGmailUnrespondedStepSchema,
+  async execute(step, args, ctx) {
+    const internalUrl = new URL("http://127.0.0.1/");
+    const request = step.request;
+    return ctx.getGmailUnresponded(
+      internalUrl,
+      request ?? {},
+      new Date(args.startedAt)
+    );
+  }
+};
+const getHealthSummaryStepSchema = z.object({
+  kind: z.literal("get_health_summary"),
+  ...baseStepFields,
+  request: z.record(z.string(), z.unknown()).optional()
+});
+const getHealthSummaryContribution = {
+  kind: "get_health_summary",
+  describe: {
+    label: "Get health summary",
+    description: "Read the LifeOps health summary (sleep, activity, vitals).",
+    provider: "app-lifeops:default"
+  },
+  paramSchema: getHealthSummaryStepSchema,
+  async execute(step, _args, ctx) {
+    const request = step.request;
+    return ctx.getHealthSummary(
+      request ?? {}
+    );
+  }
+};
+const dispatchWorkflowStepSchema = z.object({
+  kind: z.literal("dispatch_workflow"),
+  ...baseStepFields,
+  workflowId: z.string().min(1),
+  payload: z.record(z.string(), z.unknown()).optional()
+});
+const dispatchWorkflowContribution = {
+  kind: "dispatch_workflow",
+  describe: {
+    label: "Dispatch nested workflow",
+    description: "Invoke another workflow by id via the WORKFLOW_DISPATCH service, threading the parent run's request + accumulated outputs.",
+    provider: "app-lifeops:default"
+  },
+  paramSchema: dispatchWorkflowStepSchema,
+  async execute(step, args, ctx) {
+    const typed = step;
+    const dispatch = ctx.runtime.getService(
+      "WORKFLOW_DISPATCH"
+    );
+    if (!dispatch || typeof dispatch.execute !== "function") {
+      return {
+        ok: false,
+        error: "WORKFLOW_DISPATCH service not registered"
+      };
+    }
+    return dispatch.execute(typed.workflowId, {
+      ...typed.payload ?? {},
+      request: args.request,
+      outputs: args.outputs
+    });
+  }
+};
+const summarizeStepSchema = z.object({
+  kind: z.literal("summarize"),
+  ...baseStepFields,
+  sourceKey: z.string().optional(),
+  prompt: z.string().optional()
+});
+const summarizeContribution = {
+  kind: "summarize",
+  describe: {
+    label: "Summarize prior output",
+    description: "Describe the previous step (or a named output via sourceKey) using describeWorkflowValue.",
+    provider: "app-lifeops:default"
+  },
+  paramSchema: summarizeStepSchema,
+  async execute(step, args, _ctx) {
+    const typed = step;
+    const sourceValue = (typed.sourceKey ? args.outputs[typed.sourceKey] : args.previousStepValue) ?? null;
+    return {
+      text: describeWorkflowValue(sourceValue, typed.prompt)
+    };
+  }
+};
+const browserStepSchema = z.object({
+  kind: z.literal("browser"),
+  ...baseStepFields,
+  sessionTitle: z.string().min(1),
+  actions: z.array(z.record(z.string(), z.unknown())).min(1)
+});
+const browserContribution = {
+  kind: "browser",
+  describe: {
+    label: "Run browser session",
+    description: "Open a browser session for the workflow; honors permissionPolicy.allowBrowserActions and confirmation flags.",
+    provider: "app-lifeops:default"
+  },
+  paramSchema: browserStepSchema,
+  async execute(step, args, ctx) {
+    const typed = step;
+    if (!args.definition.permissionPolicy.allowBrowserActions) {
+      return {
+        blocked: true,
+        reason: "browser_actions_disabled"
+      };
+    }
+    const session = await ctx.createBrowserSessionInternal({
+      workflowId: args.definition.id,
+      title: typed.sessionTitle,
+      actions: typed.actions,
+      ownership: {
+        domain: args.definition.domain,
+        subjectType: args.definition.subjectType,
+        subjectId: args.definition.subjectId,
+        visibilityScope: args.definition.visibilityScope,
+        contextPolicy: args.definition.contextPolicy
+      }
+    });
+    if (session.awaitingConfirmationForActionId && !args.definition.permissionPolicy.trustedBrowserActions && !args.confirmBrowserActions) {
+      return {
+        sessionId: session.id,
+        status: session.status,
+        requiresConfirmation: true
+      };
+    }
+    const updated = {
+      ...session,
+      status: "queued",
+      awaitingConfirmationForActionId: null,
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await ctx.repository.updateBrowserSession(updated);
+    await ctx.recordBrowserAudit(
+      "browser_session_updated",
+      updated.id,
+      "browser session started",
+      { workflowId: args.definition.id },
+      { status: updated.status }
+    );
+    return {
+      sessionId: updated.id,
+      status: updated.status,
+      requiresConfirmation: false
+    };
+  }
+};
+const APP_LIFEOPS_WORKFLOW_STEP_CONTRIBUTIONS = [
+  createTaskContribution,
+  relockWebsiteAccessContribution,
+  resolveWebsiteAccessCallbackContribution,
+  getCalendarFeedContribution,
+  getGmailTriageContribution,
+  getGmailUnrespondedContribution,
+  getHealthSummaryContribution,
+  dispatchWorkflowContribution,
+  summarizeContribution,
+  browserContribution
+];
+function registerDefaultWorkflowStepPack(registry) {
+  for (const contribution of APP_LIFEOPS_WORKFLOW_STEP_CONTRIBUTIONS) {
+    registry.register(contribution);
+  }
+}
+export {
+  APP_LIFEOPS_WORKFLOW_STEP_CONTRIBUTIONS,
+  registerDefaultWorkflowStepPack
+};
+//# sourceMappingURL=workflow-step-default-pack.js.map

package/dist/lifeops/registries/workflow-step-default-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/registries/workflow-step-default-pack.ts"],"sourcesContent":["/**\n * Default WorkflowStepRegistry pack.\n *\n * Lifts the 9-branch `if/else` switch from `service-mixin-workflows.ts`\n * (audit `rigidity-hunt-audit.md` top-2: workflow step dispatch) into 10\n * registry contributions — one per existing `step.kind`. Pure refactor:\n * each handler is the same body that previously lived inside the switch\n * arm. Behavior must be identical.\n *\n * The 10 contributions:\n *   1. `create_task` — delegate to `LifeOpsServiceBase.createDefinition`,\n *      defaulting ownership to the workflow's domain/subject when the\n *      step omits its own ownership block.\n *   2. `relock_website_access` — call `relockWebsiteAccessGroup(groupKey, now)`.\n *   3. `resolve_website_access_callback` —\n *      call `resolveWebsiteAccessCallback(callbackKey, now)`.\n *   4. `get_calendar_feed` — invoke `getCalendarFeed` with an internal URL.\n *   5. `get_gmail_triage` — invoke `getGmailTriage`.\n *   6. `get_gmail_unresponded` — invoke `getGmailUnresponded`.\n *   7. `get_health_summary` — invoke `getHealthSummary`.\n *   8. `dispatch_workflow` — resolve `WORKFLOW_DISPATCH` service and\n *      delegate, threading the workflow `request` + accumulated outputs.\n *   9. `summarize` — describe the previous step or named-output value.\n *  10. `browser` — open a browser session honoring the workflow's\n *      permission policy + confirmation flag.\n */\n\nimport { z } from \"zod\";\nimport { describeWorkflowValue } from \"../service-helpers-browser.js\";\nimport type {\n  AnyWorkflowStepContribution,\n  WorkflowStepRegistry,\n} from \"./workflow-step-registry.js\";\n\nconst baseStepFields = {\n  id: z.string().optional(),\n  resultKey: z.string().optional(),\n} as const;\n\n// -- 1. create_task -------------------------------------------------------\n\nconst createTaskStepSchema = z.object({\n  kind: z.literal(\"create_task\"),\n  ...baseStepFields,\n  // Request body forwarded to createDefinition; full schema lives in\n  // service-normalize-task.ts and runs at intake. Registry only enforces\n  // record-shape + presence, not the full CreateLifeOpsDefinitionRequest.\n  request: z.record(z.string(), z.unknown()),\n});\n\nconst createTaskContribution: AnyWorkflowStepContribution = {\n  kind: \"create_task\",\n  describe: {\n    label: \"Create task\",\n    description:\n      \"Create a LifeOpsTaskDefinition; defaults ownership to the workflow's domain when omitted.\",\n    provider: \"app-lifeops:default\",\n  },\n  paramSchema: createTaskStepSchema,\n  async execute(step, args, ctx) {\n    const typed = step as z.infer<typeof createTaskStepSchema>;\n    const stepRequest = typed.request as {\n      ownership?: unknown;\n      [key: string]: unknown;\n    };\n    const created = await ctx.createDefinition({\n      ...stepRequest,\n      ownership: stepRequest.ownership ?? {\n        domain: args.definition.domain,\n        subjectType: args.definition.subjectType,\n        subjectId: args.definition.subjectId,\n        visibilityScope: args.definition.visibilityScope,\n        contextPolicy: args.definition.contextPolicy,\n      },\n    } as Parameters<typeof ctx.createDefinition>[0]);\n    return {\n      definitionId: created.definition.id,\n      title: created.definition.title,\n      reminderPlanId: created.reminderPlan?.id ?? null,\n    };\n  },\n};\n\n// -- 2. relock_website_access --------------------------------------------\n\nconst relockWebsiteAccessStepSchema = z.object({\n  kind: z.literal(\"relock_website_access\"),\n  ...baseStepFields,\n  request: z.object({\n    groupKey: z.string().min(1),\n  }),\n});\n\nconst relockWebsiteAccessContribution: AnyWorkflowStepContribution = {\n  kind: \"relock_website_access\",\n  describe: {\n    label: \"Re-lock website access group\",\n    description: \"Revoke any active website-access grants for the named group.\",\n    provider: \"app-lifeops:default\",\n  },\n  paramSchema: relockWebsiteAccessStepSchema,\n  async execute(step, args, ctx) {\n    const typed = step as z.infer<typeof relockWebsiteAccessStepSchema>;\n    return ctx.relockWebsiteAccessGroup(\n      typed.request.groupKey,\n      new Date(args.startedAt),\n    );\n  },\n};\n\n// -- 3. resolve_website_access_callback ----------------------------------\n\nconst resolveWebsiteAccessCallbackStepSchema = z.object({\n  kind: z.literal(\"resolve_website_access_callback\"),\n  ...baseStepFields,\n  request: z.object({\n    callbackKey: z.string().min(1),\n  }),\n});\n\nconst resolveWebsiteAccessCallbackContribution: AnyWorkflowStepContribution = {\n  kind: \"resolve_website_access_callback\",\n  describe: {\n    label: \"Resolve website-access callback\",\n    description: \"Revoke website-access grants tied to a callback key.\",\n    provider: \"app-lifeops:default\",\n  },\n  paramSchema: resolveWebsiteAccessCallbackStepSchema,\n  async execute(step, args, ctx) {\n    const typed = step as z.infer<\n      typeof resolveWebsiteAccessCallbackStepSchema\n    >;\n    return ctx.resolveWebsiteAccessCallback(\n      typed.request.callbackKey,\n      new Date(args.startedAt),\n    );\n  },\n};\n\n// -- 4. get_calendar_feed -------------------------------------------------\n\nconst getCalendarFeedStepSchema = z.object({\n  kind: z.literal(\"get_calendar_feed\"),\n  ...baseStepFields,\n  request: z.record(z.string(), z.unknown()).optional(),\n});\n\nconst getCalendarFeedContribution: AnyWorkflowStepContribution = {\n  kind: \"get_calendar_feed\",\n  describe: {\n    label: \"Get calendar feed\",\n    description:\n      \"Read the LifeOps calendar feed (events + suggestions) at the run instant.\",\n    provider: \"app-lifeops:default\",\n  },\n  paramSchema: getCalendarFeedStepSchema,\n  async execute(step, args, ctx) {\n    const internalUrl = new URL(\"http://127.0.0.1/\");\n    const request = (step as z.infer<typeof getCalendarFeedStepSchema>).request;\n    return ctx.getCalendarFeed(\n      internalUrl,\n      (request ?? {}) as Parameters<typeof ctx.getCalendarFeed>[1],\n      new Date(args.startedAt),\n    );\n  },\n};\n\n// -- 5. get_gmail_triage --------------------------------------------------\n\nconst getGmailTriageStepSchema = z.object({\n  kind: z.literal(\"get_gmail_triage\"),\n  ...baseStepFields,\n  request: z.record(z.string(), z.unknown()).optional(),\n});\n\nconst getGmailTriageContribution: AnyWorkflowStepContribution = {\n  kind: \"get_gmail_triage\",\n  describe: {\n    label: \"Get Gmail triage\",\n    description: \"Read the Gmail triage feed (priority, drafts, unread).\",\n    provider: \"app-lifeops:default\",\n  },\n  paramSchema: getGmailTriageStepSchema,\n  async execute(step, args, ctx) {\n    const internalUrl = new URL(\"http://127.0.0.1/\");\n    const request = (step as z.infer<typeof getGmailTriageStepSchema>).request;\n    return ctx.getGmailTriage(\n      internalUrl,\n      (request ?? {}) as Parameters<typeof ctx.getGmailTriage>[1],\n      new Date(args.startedAt),\n    );\n  },\n};\n\n// -- 6. get_gmail_unresponded --------------------------------------------\n\nconst getGmailUnrespondedStepSchema = z.object({\n  kind: z.literal(\"get_gmail_unresponded\"),\n  ...baseStepFields,\n  request: z.record(z.string(), z.unknown()).optional(),\n});\n\nconst getGmailUnrespondedContribution: AnyWorkflowStepContribution = {\n  kind: \"get_gmail_unresponded\",\n  describe: {\n    label: \"Get unresponded Gmail thread\",\n    description:\n      \"Read Gmail threads awaiting a reply older than the threshold.\",\n    provider: \"app-lifeops:default\",\n  },\n  paramSchema: getGmailUnrespondedStepSchema,\n  async execute(step, args, ctx) {\n    const internalUrl = new URL(\"http://127.0.0.1/\");\n    const request = (step as z.infer<typeof getGmailUnrespondedStepSchema>)\n      .request;\n    return ctx.getGmailUnresponded(\n      internalUrl,\n      (request ?? {}) as Parameters<typeof ctx.getGmailUnresponded>[1],\n      new Date(args.startedAt),\n    );\n  },\n};\n\n// -- 7. get_health_summary -----------------------------------------------\n\nconst getHealthSummaryStepSchema = z.object({\n  kind: z.literal(\"get_health_summary\"),\n  ...baseStepFields,\n  request: z.record(z.string(), z.unknown()).optional(),\n});\n\nconst getHealthSummaryContribution: AnyWorkflowStepContribution = {\n  kind: \"get_health_summary\",\n  describe: {\n    label: \"Get health summary\",\n    description: \"Read the LifeOps health summary (sleep, activity, vitals).\",\n    provider: \"app-lifeops:default\",\n  },\n  paramSchema: getHealthSummaryStepSchema,\n  async execute(step, _args, ctx) {\n    const request = (step as z.infer<typeof getHealthSummaryStepSchema>)\n      .request;\n    return ctx.getHealthSummary(\n      (request ?? {}) as Parameters<typeof ctx.getHealthSummary>[0],\n    );\n  },\n};\n\n// -- 8. dispatch_workflow -------------------------------------------------\n\nconst dispatchWorkflowStepSchema = z.object({\n  kind: z.literal(\"dispatch_workflow\"),\n  ...baseStepFields,\n  workflowId: z.string().min(1),\n  payload: z.record(z.string(), z.unknown()).optional(),\n});\n\ninterface WorkflowDispatchServiceLike {\n  execute?: (\n    workflowId: string,\n    payload?: Record<string, unknown>,\n  ) => Promise<unknown>;\n}\n\nconst dispatchWorkflowContribution: AnyWorkflowStepContribution = {\n  kind: \"dispatch_workflow\",\n  describe: {\n    label: \"Dispatch nested workflow\",\n    description:\n      \"Invoke another workflow by id via the WORKFLOW_DISPATCH service, threading the parent run's request + accumulated outputs.\",\n    provider: \"app-lifeops:default\",\n  },\n  paramSchema: dispatchWorkflowStepSchema,\n  async execute(step, args, ctx) {\n    const typed = step as z.infer<typeof dispatchWorkflowStepSchema>;\n    const dispatch = ctx.runtime.getService(\n      \"WORKFLOW_DISPATCH\",\n    ) as WorkflowDispatchServiceLike | null;\n    if (!dispatch || typeof dispatch.execute !== \"function\") {\n      return {\n        ok: false,\n        error: \"WORKFLOW_DISPATCH service not registered\",\n      };\n    }\n    return dispatch.execute(typed.workflowId, {\n      ...(typed.payload ?? {}),\n      request: args.request,\n      outputs: args.outputs,\n    });\n  },\n};\n\n// -- 9. summarize ---------------------------------------------------------\n\nconst summarizeStepSchema = z.object({\n  kind: z.literal(\"summarize\"),\n  ...baseStepFields,\n  sourceKey: z.string().optional(),\n  prompt: z.string().optional(),\n});\n\nconst summarizeContribution: AnyWorkflowStepContribution = {\n  kind: \"summarize\",\n  describe: {\n    label: \"Summarize prior output\",\n    description:\n      \"Describe the previous step (or a named output via sourceKey) using describeWorkflowValue.\",\n    provider: \"app-lifeops:default\",\n  },\n  paramSchema: summarizeStepSchema,\n  async execute(step, args, _ctx) {\n    const typed = step as z.infer<typeof summarizeStepSchema>;\n    const sourceValue =\n      (typed.sourceKey\n        ? args.outputs[typed.sourceKey]\n        : args.previousStepValue) ?? null;\n    return {\n      text: describeWorkflowValue(sourceValue, typed.prompt),\n    };\n  },\n};\n\n// -- 10. browser ----------------------------------------------------------\n\nconst browserStepSchema = z.object({\n  kind: z.literal(\"browser\"),\n  ...baseStepFields,\n  sessionTitle: z.string().min(1),\n  actions: z.array(z.record(z.string(), z.unknown())).min(1),\n});\n\nconst browserContribution: AnyWorkflowStepContribution = {\n  kind: \"browser\",\n  describe: {\n    label: \"Run browser session\",\n    description:\n      \"Open a browser session for the workflow; honors permissionPolicy.allowBrowserActions and confirmation flags.\",\n    provider: \"app-lifeops:default\",\n  },\n  paramSchema: browserStepSchema,\n  async execute(step, args, ctx) {\n    const typed = step as z.infer<typeof browserStepSchema>;\n    if (!args.definition.permissionPolicy.allowBrowserActions) {\n      return {\n        blocked: true,\n        reason: \"browser_actions_disabled\" as const,\n      };\n    }\n    const session = await ctx.createBrowserSessionInternal({\n      workflowId: args.definition.id,\n      title: typed.sessionTitle,\n      actions: typed.actions as Parameters<\n        typeof ctx.createBrowserSessionInternal\n      >[0][\"actions\"],\n      ownership: {\n        domain: args.definition.domain,\n        subjectType: args.definition.subjectType,\n        subjectId: args.definition.subjectId,\n        visibilityScope: args.definition.visibilityScope,\n        contextPolicy: args.definition.contextPolicy,\n      },\n    });\n    if (\n      session.awaitingConfirmationForActionId &&\n      !args.definition.permissionPolicy.trustedBrowserActions &&\n      !args.confirmBrowserActions\n    ) {\n      return {\n        sessionId: session.id,\n        status: session.status,\n        requiresConfirmation: true,\n      };\n    }\n    const updated = {\n      ...session,\n      status: \"queued\" as const,\n      awaitingConfirmationForActionId: null,\n      updatedAt: new Date().toISOString(),\n    };\n    await ctx.repository.updateBrowserSession(updated);\n    await ctx.recordBrowserAudit(\n      \"browser_session_updated\",\n      updated.id,\n      \"browser session started\",\n      { workflowId: args.definition.id },\n      { status: updated.status },\n    );\n    return {\n      sessionId: updated.id,\n      status: updated.status,\n      requiresConfirmation: false,\n    };\n  },\n};\n\n// ---------------------------------------------------------------------------\n\nexport const APP_LIFEOPS_WORKFLOW_STEP_CONTRIBUTIONS: readonly AnyWorkflowStepContribution[] =\n  [\n    createTaskContribution,\n    relockWebsiteAccessContribution,\n    resolveWebsiteAccessCallbackContribution,\n    getCalendarFeedContribution,\n    getGmailTriageContribution,\n    getGmailUnrespondedContribution,\n    getHealthSummaryContribution,\n    dispatchWorkflowContribution,\n    summarizeContribution,\n    browserContribution,\n  ];\n\nexport function registerDefaultWorkflowStepPack(\n  registry: WorkflowStepRegistry,\n): void {\n  for (const contribution of APP_LIFEOPS_WORKFLOW_STEP_CONTRIBUTIONS) {\n    registry.register(contribution);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/lifeops/registries/workflow-step-registry.d.ts

@@ -0,0 +1,101 @@
+/**
+ * WorkflowStepRegistry — open registry of executable workflow step kinds.
+ *
+ * Open registry of executable workflow step kinds. Plugins and tests can
+ * register a new step kind at runtime by contributing a
+ * `WorkflowStepContribution`; the dispatcher consults this registry.
+ *
+ * Follows the same per-runtime `WeakMap` binding pattern as
+ * `AnchorRegistry` / `EventKindRegistry` / `FamilyRegistry`.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { CreateLifeOpsBrowserSessionRequest, CreateLifeOpsDefinitionRequest, GetLifeOpsCalendarFeedRequest, GetLifeOpsGmailTriageRequest, GetLifeOpsGmailUnrespondedRequest, GetLifeOpsHealthSummaryRequest, LifeOpsBrowserSession, LifeOpsCalendarFeed, LifeOpsDefinitionRecord, LifeOpsGmailTriageFeed, LifeOpsGmailUnrespondedFeed, LifeOpsHealthSummaryResponse, LifeOpsWorkflowDefinition } from "@elizaos/shared";
+import type { z } from "zod";
+/**
+ * Strongly-typed surface of `LifeOpsServiceBase` (composed mixins) that the
+ * default workflow-step contributions consume. Defining the shape here lets
+ * each contribution's `execute` callback take a typed `ctx` parameter
+ * instead of an opaque `any`. Third-party contributions can rely on the
+ * documented surface; nothing inside the dispatcher leaks.
+ */
+export interface WorkflowStepExecuteContext {
+    readonly runtime: IAgentRuntime;
+    readonly repository: {
+        updateBrowserSession(session: LifeOpsBrowserSession): Promise<void>;
+    };
+    createDefinition(request: CreateLifeOpsDefinitionRequest): Promise<LifeOpsDefinitionRecord>;
+    relockWebsiteAccessGroup(groupKey: string, now?: Date): Promise<{
+        ok: true;
+    }>;
+    resolveWebsiteAccessCallback(callbackKey: string, now?: Date): Promise<{
+        ok: true;
+    }>;
+    getCalendarFeed(requestUrl: URL, request?: GetLifeOpsCalendarFeedRequest, now?: Date): Promise<LifeOpsCalendarFeed>;
+    getGmailTriage(requestUrl: URL, request?: GetLifeOpsGmailTriageRequest, now?: Date): Promise<LifeOpsGmailTriageFeed>;
+    getGmailUnresponded(requestUrl: URL, request?: GetLifeOpsGmailUnrespondedRequest, now?: Date): Promise<LifeOpsGmailUnrespondedFeed>;
+    getHealthSummary(request?: GetLifeOpsHealthSummaryRequest): Promise<LifeOpsHealthSummaryResponse>;
+    createBrowserSessionInternal(request: CreateLifeOpsBrowserSessionRequest): Promise<LifeOpsBrowserSession>;
+    recordBrowserAudit(eventType: "browser_session_created" | "browser_session_updated", ownerId: string, reason: string, inputs: Record<string, unknown>, decision: Record<string, unknown>): Promise<void>;
+}
+/**
+ * Per-step execution arguments passed alongside the step itself. Carries the
+ * workflow's owning definition (for permission policy / ownership defaults),
+ * the run timestamp, the accumulated `outputs` map, and the latest step's
+ * recorded value (used by `summarize`).
+ */
+export interface WorkflowStepExecuteArgs {
+    readonly definition: LifeOpsWorkflowDefinition;
+    readonly startedAt: string;
+    readonly confirmBrowserActions: boolean;
+    readonly request: Record<string, unknown>;
+    readonly outputs: Record<string, unknown>;
+    readonly previousStepValue: unknown;
+}
+export interface WorkflowStepContribution<TStep extends {
+    kind: string;
+} = {
+    kind: string;
+}, TResult = unknown> {
+    /** Stable identifier — must match `step.kind` at dispatch time. */
+    readonly kind: string;
+    readonly describe: {
+        label: string;
+        description: string;
+        provider: string;
+    };
+    /**
+     * Zod schema validated against the raw step record before execution. The
+     * schema is the source of truth for the contribution's parameter shape;
+     * its inferred type drives `execute`'s `step` parameter.
+     */
+    readonly paramSchema: z.ZodType<TStep>;
+    /**
+     * Execute the step. Receives the validated step + per-run args + the
+     * typed service context.
+     */
+    execute(step: TStep, args: WorkflowStepExecuteArgs, ctx: WorkflowStepExecuteContext): Promise<TResult>;
+}
+export type AnyWorkflowStepContribution = WorkflowStepContribution<{
+    kind: string;
+}, unknown>;
+/**
+ * Thrown when the dispatcher encounters a `step.kind` with no registered
+ * contribution. Carries the offending kind + the current registered set so
+ * planners can surface a precise diagnostic.
+ */
+export declare class UnknownWorkflowStepError extends Error {
+    readonly kind: string;
+    readonly knownKinds: readonly string[];
+    constructor(kind: string, knownKinds: readonly string[]);
+}
+export interface WorkflowStepRegistry {
+    register(contribution: AnyWorkflowStepContribution): void;
+    has(kind: string): boolean;
+    get(kind: string): AnyWorkflowStepContribution | null;
+    list(): AnyWorkflowStepContribution[];
+}
+export declare function createWorkflowStepRegistry(): WorkflowStepRegistry;
+export declare function registerWorkflowStepRegistry(runtime: IAgentRuntime, registry: WorkflowStepRegistry): void;
+export declare function getWorkflowStepRegistry(runtime: IAgentRuntime): WorkflowStepRegistry | null;
+export declare function __resetWorkflowStepRegistryForTests(runtime: IAgentRuntime): void;
+//# sourceMappingURL=workflow-step-registry.d.ts.map

package/dist/lifeops/registries/workflow-step-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-step-registry.d.ts","sourceRoot":"","sources":["../../../src/lifeops/registries/workflow-step-registry.ts"],"names":[],"mappings":"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"}

package/dist/lifeops/registries/workflow-step-registry.js

@@ -0,0 +1,56 @@
+class UnknownWorkflowStepError extends Error {
+  kind;
+  knownKinds;
+  constructor(kind, knownKinds) {
+    super(
+      `Unknown workflow step kind "${kind}". Registered kinds: ${knownKinds.length === 0 ? "(none)" : knownKinds.join(", ")}`
+    );
+    this.name = "UnknownWorkflowStepError";
+    this.kind = kind;
+    this.knownKinds = knownKinds;
+  }
+}
+class InMemoryWorkflowStepRegistry {
+  byKind = /* @__PURE__ */ new Map();
+  register(contribution) {
+    if (!contribution.kind) {
+      throw new Error("WorkflowStepRegistry.register: kind is required");
+    }
+    if (this.byKind.has(contribution.kind)) {
+      throw new Error(
+        `WorkflowStepRegistry.register: kind "${contribution.kind}" already registered`
+      );
+    }
+    this.byKind.set(contribution.kind, contribution);
+  }
+  has(kind) {
+    return this.byKind.has(kind);
+  }
+  get(kind) {
+    return this.byKind.get(kind) ?? null;
+  }
+  list() {
+    return Array.from(this.byKind.values());
+  }
+}
+function createWorkflowStepRegistry() {
+  return new InMemoryWorkflowStepRegistry();
+}
+const registries = /* @__PURE__ */ new WeakMap();
+function registerWorkflowStepRegistry(runtime, registry) {
+  registries.set(runtime, registry);
+}
+function getWorkflowStepRegistry(runtime) {
+  return registries.get(runtime) ?? null;
+}
+function __resetWorkflowStepRegistryForTests(runtime) {
+  registries.delete(runtime);
+}
+export {
+  UnknownWorkflowStepError,
+  __resetWorkflowStepRegistryForTests,
+  createWorkflowStepRegistry,
+  getWorkflowStepRegistry,
+  registerWorkflowStepRegistry
+};
+//# sourceMappingURL=workflow-step-registry.js.map

package/dist/lifeops/registries/workflow-step-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/registries/workflow-step-registry.ts"],"sourcesContent":["/**\n * WorkflowStepRegistry — open registry of executable workflow step kinds.\n *\n * Open registry of executable workflow step kinds. Plugins and tests can\n * register a new step kind at runtime by contributing a\n * `WorkflowStepContribution`; the dispatcher consults this registry.\n *\n * Follows the same per-runtime `WeakMap` binding pattern as\n * `AnchorRegistry` / `EventKindRegistry` / `FamilyRegistry`.\n */\n\nimport type { IAgentRuntime } from \"@elizaos/core\";\nimport type {\n  CreateLifeOpsBrowserSessionRequest,\n  CreateLifeOpsDefinitionRequest,\n  GetLifeOpsCalendarFeedRequest,\n  GetLifeOpsGmailTriageRequest,\n  GetLifeOpsGmailUnrespondedRequest,\n  GetLifeOpsHealthSummaryRequest,\n  LifeOpsBrowserSession,\n  LifeOpsCalendarFeed,\n  LifeOpsDefinitionRecord,\n  LifeOpsGmailTriageFeed,\n  LifeOpsGmailUnrespondedFeed,\n  LifeOpsHealthSummaryResponse,\n  LifeOpsWorkflowDefinition,\n} from \"@elizaos/shared\";\nimport type { z } from \"zod\";\n\n/**\n * Strongly-typed surface of `LifeOpsServiceBase` (composed mixins) that the\n * default workflow-step contributions consume. Defining the shape here lets\n * each contribution's `execute` callback take a typed `ctx` parameter\n * instead of an opaque `any`. Third-party contributions can rely on the\n * documented surface; nothing inside the dispatcher leaks.\n */\nexport interface WorkflowStepExecuteContext {\n  readonly runtime: IAgentRuntime;\n  readonly repository: {\n    updateBrowserSession(session: LifeOpsBrowserSession): Promise<void>;\n  };\n\n  createDefinition(\n    request: CreateLifeOpsDefinitionRequest,\n  ): Promise<LifeOpsDefinitionRecord>;\n\n  relockWebsiteAccessGroup(groupKey: string, now?: Date): Promise<{ ok: true }>;\n\n  resolveWebsiteAccessCallback(\n    callbackKey: string,\n    now?: Date,\n  ): Promise<{ ok: true }>;\n\n  getCalendarFeed(\n    requestUrl: URL,\n    request?: GetLifeOpsCalendarFeedRequest,\n    now?: Date,\n  ): Promise<LifeOpsCalendarFeed>;\n\n  getGmailTriage(\n    requestUrl: URL,\n    request?: GetLifeOpsGmailTriageRequest,\n    now?: Date,\n  ): Promise<LifeOpsGmailTriageFeed>;\n\n  getGmailUnresponded(\n    requestUrl: URL,\n    request?: GetLifeOpsGmailUnrespondedRequest,\n    now?: Date,\n  ): Promise<LifeOpsGmailUnrespondedFeed>;\n\n  getHealthSummary(\n    request?: GetLifeOpsHealthSummaryRequest,\n  ): Promise<LifeOpsHealthSummaryResponse>;\n\n  createBrowserSessionInternal(\n    request: CreateLifeOpsBrowserSessionRequest,\n  ): Promise<LifeOpsBrowserSession>;\n\n  recordBrowserAudit(\n    eventType: \"browser_session_created\" | \"browser_session_updated\",\n    ownerId: string,\n    reason: string,\n    inputs: Record<string, unknown>,\n    decision: Record<string, unknown>,\n  ): Promise<void>;\n}\n\n/**\n * Per-step execution arguments passed alongside the step itself. Carries the\n * workflow's owning definition (for permission policy / ownership defaults),\n * the run timestamp, the accumulated `outputs` map, and the latest step's\n * recorded value (used by `summarize`).\n */\nexport interface WorkflowStepExecuteArgs {\n  readonly definition: LifeOpsWorkflowDefinition;\n  readonly startedAt: string;\n  readonly confirmBrowserActions: boolean;\n  readonly request: Record<string, unknown>;\n  readonly outputs: Record<string, unknown>;\n  readonly previousStepValue: unknown;\n}\n\nexport interface WorkflowStepContribution<\n  TStep extends { kind: string } = { kind: string },\n  TResult = unknown,\n> {\n  /** Stable identifier — must match `step.kind` at dispatch time. */\n  readonly kind: string;\n  readonly describe: { label: string; description: string; provider: string };\n  /**\n   * Zod schema validated against the raw step record before execution. The\n   * schema is the source of truth for the contribution's parameter shape;\n   * its inferred type drives `execute`'s `step` parameter.\n   */\n  readonly paramSchema: z.ZodType<TStep>;\n  /**\n   * Execute the step. Receives the validated step + per-run args + the\n   * typed service context.\n   */\n  execute(\n    step: TStep,\n    args: WorkflowStepExecuteArgs,\n    ctx: WorkflowStepExecuteContext,\n  ): Promise<TResult>;\n}\n\nexport type AnyWorkflowStepContribution = WorkflowStepContribution<\n  { kind: string },\n  unknown\n>;\n\n/**\n * Thrown when the dispatcher encounters a `step.kind` with no registered\n * contribution. Carries the offending kind + the current registered set so\n * planners can surface a precise diagnostic.\n */\nexport class UnknownWorkflowStepError extends Error {\n  public readonly kind: string;\n  public readonly knownKinds: readonly string[];\n\n  constructor(kind: string, knownKinds: readonly string[]) {\n    super(\n      `Unknown workflow step kind \"${kind}\". Registered kinds: ${\n        knownKinds.length === 0 ? \"(none)\" : knownKinds.join(\", \")\n      }`,\n    );\n    this.name = \"UnknownWorkflowStepError\";\n    this.kind = kind;\n    this.knownKinds = knownKinds;\n  }\n}\n\nexport interface WorkflowStepRegistry {\n  register(contribution: AnyWorkflowStepContribution): void;\n  has(kind: string): boolean;\n  get(kind: string): AnyWorkflowStepContribution | null;\n  list(): AnyWorkflowStepContribution[];\n}\n\nclass InMemoryWorkflowStepRegistry implements WorkflowStepRegistry {\n  private readonly byKind = new Map<string, AnyWorkflowStepContribution>();\n\n  register(contribution: AnyWorkflowStepContribution): void {\n    if (!contribution.kind) {\n      throw new Error(\"WorkflowStepRegistry.register: kind is required\");\n    }\n    if (this.byKind.has(contribution.kind)) {\n      throw new Error(\n        `WorkflowStepRegistry.register: kind \"${contribution.kind}\" already registered`,\n      );\n    }\n    this.byKind.set(contribution.kind, contribution);\n  }\n\n  has(kind: string): boolean {\n    return this.byKind.has(kind);\n  }\n\n  get(kind: string): AnyWorkflowStepContribution | null {\n    return this.byKind.get(kind) ?? null;\n  }\n\n  list(): AnyWorkflowStepContribution[] {\n    return Array.from(this.byKind.values());\n  }\n}\n\nexport function createWorkflowStepRegistry(): WorkflowStepRegistry {\n  return new InMemoryWorkflowStepRegistry();\n}\n\n// ---------------------------------------------------------------------------\n// Per-runtime registration. Mirrors AnchorRegistry / EventKindRegistry /\n// FamilyRegistry — `WeakMap` keyed by runtime so the lifetime tracks the\n// runtime and we don't leak across tests.\n// ---------------------------------------------------------------------------\n\nconst registries = new WeakMap<IAgentRuntime, WorkflowStepRegistry>();\n\nexport function registerWorkflowStepRegistry(\n  runtime: IAgentRuntime,\n  registry: WorkflowStepRegistry,\n): void {\n  registries.set(runtime, registry);\n}\n\nexport function getWorkflowStepRegistry(\n  runtime: IAgentRuntime,\n): WorkflowStepRegistry | null {\n  return registries.get(runtime) ?? null;\n}\n\nexport function __resetWorkflowStepRegistryForTests(\n  runtime: IAgentRuntime,\n): void {\n  registries.delete(runtime);\n}\n"],"mappings":"AAyIO,MAAM,iCAAiC,MAAM;AAAA,EAClC;AAAA,EACA;AAAA,EAEhB,YAAY,MAAc,YAA+B;AACvD;AAAA,MACE,+BAA+B,IAAI,wBACjC,WAAW,WAAW,IAAI,WAAW,WAAW,KAAK,IAAI,CAC3D;AAAA,IACF;AACA,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,aAAa;AAAA,EACpB;AACF;AASA,MAAM,6BAA6D;AAAA,EAChD,SAAS,oBAAI,IAAyC;AAAA,EAEvE,SAAS,cAAiD;AACxD,QAAI,CAAC,aAAa,MAAM;AACtB,YAAM,IAAI,MAAM,iDAAiD;AAAA,IACnE;AACA,QAAI,KAAK,OAAO,IAAI,aAAa,IAAI,GAAG;AACtC,YAAM,IAAI;AAAA,QACR,wCAAwC,aAAa,IAAI;AAAA,MAC3D;AAAA,IACF;AACA,SAAK,OAAO,IAAI,aAAa,MAAM,YAAY;AAAA,EACjD;AAAA,EAEA,IAAI,MAAuB;AACzB,WAAO,KAAK,OAAO,IAAI,IAAI;AAAA,EAC7B;AAAA,EAEA,IAAI,MAAkD;AACpD,WAAO,KAAK,OAAO,IAAI,IAAI,KAAK;AAAA,EAClC;AAAA,EAEA,OAAsC;AACpC,WAAO,MAAM,KAAK,KAAK,OAAO,OAAO,CAAC;AAAA,EACxC;AACF;AAEO,SAAS,6BAAmD;AACjE,SAAO,IAAI,6BAA6B;AAC1C;AAQA,MAAM,aAAa,oBAAI,QAA6C;AAE7D,SAAS,6BACd,SACA,UACM;AACN,aAAW,IAAI,SAAS,QAAQ;AAClC;AAEO,SAAS,wBACd,SAC6B;AAC7B,SAAO,WAAW,IAAI,OAAO,KAAK;AACpC;AAEO,SAAS,oCACd,SACM;AACN,aAAW,OAAO,OAAO;AAC3B;","names":[]}

package/dist/lifeops/relationships/extraction.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Extraction helpers — the canonical entry point for "ingest this
+ * observation into the graph". Tests verify these produce both nodes
+ * and edges.
+ *
+ * Take an observation tuple ("Pat is my manager at Acme") and produce a
+ * pair of (entities, edges) writes that the planner can apply
+ * atomically. All writes carry full provenance (the source utterance is
+ * the evidence id).
+ */
+import type { EntityStore } from "../entities/store.js";
+import type { Entity } from "../entities/types.js";
+import type { RelationshipStore } from "./store.js";
+import type { Relationship, RelationshipSource } from "./types.js";
+/**
+ * High-level extracted edge. The planner / chat ingest produces these
+ * from natural-language observations; the runtime applies them via
+ * `applyExtractedEdges`.
+ */
+export interface ExtractedEdge {
+    fromRef: ExtractedEntityRef;
+    toRef: ExtractedEntityRef;
+    type: string;
+    metadata?: Record<string, unknown>;
+    confidence: number;
+}
+export interface ExtractedEntityRef {
+    /** `"self"`, an existing entityId, or a name to resolve. */
+    id?: string;
+    name?: string;
+    type?: string;
+    /** Identity hints to disambiguate same-named entities. */
+    identity?: {
+        platform: string;
+        handle: string;
+    };
+}
+export interface ExtractionResult {
+    entities: Entity[];
+    relationships: Relationship[];
+    /** Evidence-id → list of (entityId, relationshipId) it touched. */
+    provenance: Record<string, {
+        entityIds: string[];
+        relationshipIds: string[];
+    }>;
+}
+/**
+ * Apply a batch of extracted edges. Resolves each entity ref to a
+ * concrete Entity (creating it if needed), then strengthens or creates
+ * each edge via `RelationshipStore.observe`.
+ *
+ * Always idempotent across re-runs of the same evidence id.
+ */
+export declare function applyExtractedEdges(args: {
+    entityStore: EntityStore;
+    relationshipStore: RelationshipStore;
+    evidenceId: string;
+    edges: ExtractedEdge[];
+    source?: RelationshipSource;
+}): Promise<ExtractionResult>;
+/**
+ * Convenience: parse a "X is my <role> at Y" statement into 2 entities +
+ * 3 edges. This is one canonical pattern; richer NL parsing lives in the
+ * planner. Returns the structured `ExtractedEdge[]` ready for
+ * `applyExtractedEdges`.
+ *
+ * Example: managerOfAtCompany("Pat", "Acme") →
+ *   - self → Pat: managed_by
+ *   - self → Acme: works_at
+ *   - Pat → Acme: works_at
+ */
+export declare function managerOfAtCompany(managerName: string, companyName: string, options?: {
+    confidence?: number;
+    managerRole?: string;
+    selfRole?: string;
+}): ExtractedEdge[];
+//# sourceMappingURL=extraction.d.ts.map

package/dist/lifeops/relationships/extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.d.ts","sourceRoot":"","sources":["../../../src/lifeops/relationships/extraction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,QAAQ,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAChB,MAAM,EACN;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE,CACnD,CAAC;CACH;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,WAAW,EAAE,WAAW,CAAC;IACzB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsI5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,GACL,aAAa,EAAE,CA6BjB"}