@contractspec/example.pocket-family-office 3.7.16 → 3.7.18

package/dist/telemetry.js

@@ -1,177 +1,2 @@
 // @bun
-// src/telemetry.ts
-import {
-  OPENBANKING_PII_FIELDS,
-  OPENBANKING_TELEMETRY_EVENTS
-} from "@contractspec/lib.contracts-integrations";
-import {
-  OwnersEnum,
-  StabilityEnum,
-  TagsEnum
-} from "@contractspec/lib.contracts-spec/ownership";
-var commonProperties = {
-  tenantId: {
-    type: "string",
-    required: true,
-    description: "Tenant identifier for multi-tenant isolation."
-  },
-  appId: {
-    type: "string",
-    required: true,
-    description: "Application identifier associated with the event."
-  },
-  blueprint: {
-    type: "string",
-    required: true,
-    description: "Blueprint name@version emitting the telemetry."
-  },
-  configVersion: {
-    type: "number",
-    required: true,
-    description: "Resolved app config version when the event was generated."
-  },
-  slotId: {
-    type: "string",
-    required: true,
-    description: "Integration slot identifier (e.g., primaryOpenBanking)."
-  },
-  connectionId: {
-    type: "string",
-    required: true,
-    description: "Integration connection ID used for the sync."
-  }
-};
-function piiSafeString(description) {
-  return {
-    type: "string",
-    description,
-    pii: false
-  };
-}
-var pocketFamilyOfficeTelemetry = {
-  meta: {
-    key: "pfo.telemetry",
-    version: "1.0.0",
-    title: "Pocket Family Office Telemetry",
-    description: "Operational telemetry for Pocket Family Office workflows, including Powens open banking syncs.",
-    domain: "finance",
-    owners: [OwnersEnum.PlatformFinance],
-    tags: ["open-banking", TagsEnum.Automation],
-    stability: StabilityEnum.Experimental
-  },
-  config: {
-    defaultRetentionDays: 180,
-    defaultSamplingRate: 1
-  },
-  events: [
-    {
-      key: OPENBANKING_TELEMETRY_EVENTS.accountsSynced,
-      version: "1.0.0",
-      semantics: {
-        what: "Open banking account synchronisation completed.",
-        why: "Refresh canonical account metadata for reporting and workflows."
-      },
-      privacy: "internal",
-      properties: {
-        ...commonProperties,
-        syncedCount: {
-          type: "number",
-          description: "Number of accounts synced successfully."
-        },
-        failedCount: {
-          type: "number",
-          description: "Number of accounts that failed to sync."
-        },
-        durationMs: {
-          type: "number",
-          description: "Duration of the sync job in milliseconds."
-        }
-      }
-    },
-    {
-      key: OPENBANKING_TELEMETRY_EVENTS.transactionsSynced,
-      version: "1.0.0",
-      semantics: {
-        what: "Open banking transaction synchronisation completed.",
-        why: "Keep canonical transaction ledger in sync for analytics."
-      },
-      privacy: "internal",
-      properties: {
-        ...commonProperties,
-        accountId: {
-          type: "string",
-          description: "Bank account identifier used during the sync.",
-          pii: false
-        },
-        syncedCount: {
-          type: "number",
-          description: "Number of transactions synced successfully."
-        },
-        failedCount: {
-          type: "number",
-          description: "Number of transactions that failed to sync."
-        },
-        from: {
-          type: "timestamp",
-          description: "Start timestamp for the sync window."
-        },
-        to: {
-          type: "timestamp",
-          description: "End timestamp for the sync window."
-        }
-      }
-    },
-    {
-      key: OPENBANKING_TELEMETRY_EVENTS.balancesRefreshed,
-      version: "1.0.0",
-      semantics: {
-        what: "Open banking balances refreshed.",
-        why: "Provide accurate cash position for dashboards and alerts."
-      },
-      privacy: "internal",
-      properties: {
-        ...commonProperties,
-        accountId: piiSafeString("Bank account identifier."),
-        balanceTypes: {
-          type: "json",
-          description: "Balance types included in the refresh."
-        },
-        refreshedAt: {
-          type: "timestamp",
-          description: "Timestamp when balances were refreshed."
-        }
-      }
-    },
-    {
-      key: OPENBANKING_TELEMETRY_EVENTS.overviewGenerated,
-      version: "1.0.0",
-      semantics: {
-        what: "Derived financial overview generated.",
-        why: "Persist cashflow and category summaries into knowledge space."
-      },
-      privacy: "internal",
-      properties: {
-        ...commonProperties,
-        knowledgeEntryId: piiSafeString("Identifier of the knowledge document containing the overview."),
-        period: {
-          type: "string",
-          description: "Aggregation period used (week, month, quarter)."
-        },
-        periodStart: {
-          type: "timestamp",
-          description: "Start timestamp for the aggregation window."
-        },
-        periodEnd: {
-          type: "timestamp",
-          description: "End timestamp for the aggregation window."
-        }
-      },
-      tags: ["knowledge", "analytics"]
-    }
-  ]
-};
-var OPENBANKING_SENSITIVE_FIELDS = OPENBANKING_PII_FIELDS;
-export {
-  pocketFamilyOfficeTelemetry,
-  OPENBANKING_SENSITIVE_FIELDS
-};
+import{OPENBANKING_PII_FIELDS as x,OPENBANKING_TELEMETRY_EVENTS as j}from"@contractspec/lib.contracts-integrations";import{OwnersEnum as z,StabilityEnum as C,TagsEnum as H}from"@contractspec/lib.contracts-spec/ownership";var k={tenantId:{type:"string",required:!0,description:"Tenant identifier for multi-tenant isolation."},appId:{type:"string",required:!0,description:"Application identifier associated with the event."},blueprint:{type:"string",required:!0,description:"Blueprint name@version emitting the telemetry."},configVersion:{type:"number",required:!0,description:"Resolved app config version when the event was generated."},slotId:{type:"string",required:!0,description:"Integration slot identifier (e.g., primaryOpenBanking)."},connectionId:{type:"string",required:!0,description:"Integration connection ID used for the sync."}};function q(v){return{type:"string",description:v,pii:!1}}var U={meta:{key:"pfo.telemetry",version:"1.0.0",title:"Pocket Family Office Telemetry",description:"Operational telemetry for Pocket Family Office workflows, including Powens open banking syncs.",domain:"finance",owners:[z.PlatformFinance],tags:["open-banking",H.Automation],stability:C.Experimental},config:{defaultRetentionDays:180,defaultSamplingRate:1},events:[{key:j.accountsSynced,version:"1.0.0",semantics:{what:"Open banking account synchronisation completed.",why:"Refresh canonical account metadata for reporting and workflows."},privacy:"internal",properties:{...k,syncedCount:{type:"number",description:"Number of accounts synced successfully."},failedCount:{type:"number",description:"Number of accounts that failed to sync."},durationMs:{type:"number",description:"Duration of the sync job in milliseconds."}}},{key:j.transactionsSynced,version:"1.0.0",semantics:{what:"Open banking transaction synchronisation completed.",why:"Keep canonical transaction ledger in sync for analytics."},privacy:"internal",properties:{...k,accountId:{type:"string",description:"Bank account identifier used during the sync.",pii:!1},syncedCount:{type:"number",description:"Number of transactions synced successfully."},failedCount:{type:"number",description:"Number of transactions that failed to sync."},from:{type:"timestamp",description:"Start timestamp for the sync window."},to:{type:"timestamp",description:"End timestamp for the sync window."}}},{key:j.balancesRefreshed,version:"1.0.0",semantics:{what:"Open banking balances refreshed.",why:"Provide accurate cash position for dashboards and alerts."},privacy:"internal",properties:{...k,accountId:q("Bank account identifier."),balanceTypes:{type:"json",description:"Balance types included in the refresh."},refreshedAt:{type:"timestamp",description:"Timestamp when balances were refreshed."}}},{key:j.overviewGenerated,version:"1.0.0",semantics:{what:"Derived financial overview generated.",why:"Persist cashflow and category summaries into knowledge space."},privacy:"internal",properties:{...k,knowledgeEntryId:q("Identifier of the knowledge document containing the overview."),period:{type:"string",description:"Aggregation period used (week, month, quarter)."},periodStart:{type:"timestamp",description:"Start timestamp for the aggregation window."},periodEnd:{type:"timestamp",description:"End timestamp for the aggregation window."}},tags:["knowledge","analytics"]}]},W=x;export{U as pocketFamilyOfficeTelemetry,W as OPENBANKING_SENSITIVE_FIELDS};

package/dist/tenant.sample.js

@@ -1,72 +1,2 @@
 // @bun
-// src/tenant.sample.ts
-var pocketFamilyOfficeTenantSample = {
-  meta: {
-    id: "tenant-pfo-sample",
-    tenantId: "tenant.family-office",
-    appId: "pocket-family-office",
-    blueprintName: "pocket-family-office.app",
-    blueprintVersion: "1.0.0",
-    environment: "production",
-    version: "1.0.0",
-    createdAt: new Date().toISOString(),
-    updatedAt: new Date().toISOString(),
-    status: "published"
-  },
-  featureFlags: [
-    {
-      key: "voice-summaries",
-      enabled: true,
-      description: "Enable spoken ElevenLabs summaries for daily briefings."
-    }
-  ],
-  integrations: [
-    { slotId: "primaryLLM", connectionId: "conn-mistral-primary" },
-    { slotId: "primaryVectorDb", connectionId: "conn-qdrant-finance" },
-    { slotId: "primaryStorage", connectionId: "conn-gcs-documents" },
-    { slotId: "primaryOpenBanking", connectionId: "conn-powens-primary" },
-    { slotId: "emailInbound", connectionId: "conn-gmail-threads" },
-    { slotId: "emailOutbound", connectionId: "conn-postmark-outbound" },
-    { slotId: "calendarScheduling", connectionId: "conn-google-calendar" },
-    { slotId: "voicePlayback", connectionId: "conn-elevenlabs-voice" },
-    { slotId: "smsNotifications", connectionId: "conn-twilio-sms" },
-    { slotId: "paymentsProcessing", connectionId: "conn-stripe-recurring" }
-  ],
-  knowledge: [
-    {
-      spaceKey: "knowledge.financial-docs",
-      scope: {
-        workflows: [
-          "pfo.workflow.process-uploaded-document",
-          "pfo.workflow.generate-financial-summary"
-        ]
-      }
-    },
-    {
-      spaceKey: "knowledge.email-threads",
-      scope: {
-        workflows: ["pfo.workflow.ingest-email-threads"]
-      }
-    },
-    {
-      spaceKey: "knowledge.financial-overview",
-      scope: {
-        workflows: [
-          "pfo.workflow.sync-openbanking-transactions",
-          "pfo.workflow.refresh-openbanking-balances",
-          "pfo.workflow.generate-financial-summary",
-          "pfo.workflow.generate-openbanking-overview"
-        ]
-      },
-      required: false
-    }
-  ],
-  locales: {
-    defaultLocale: "en",
-    enabledLocales: ["en"]
-  },
-  notes: "Sample tenant configuration for hackathon demos. Replace connection IDs with tenant-specific bindings when provisioning."
-};
-export {
-  pocketFamilyOfficeTenantSample
-};
+var n={meta:{id:"tenant-pfo-sample",tenantId:"tenant.family-office",appId:"pocket-family-office",blueprintName:"pocket-family-office.app",blueprintVersion:"1.0.0",environment:"production",version:"1.0.0",createdAt:new Date().toISOString(),updatedAt:new Date().toISOString(),status:"published"},featureFlags:[{key:"voice-summaries",enabled:!0,description:"Enable spoken ElevenLabs summaries for daily briefings."}],integrations:[{slotId:"primaryLLM",connectionId:"conn-mistral-primary"},{slotId:"primaryVectorDb",connectionId:"conn-qdrant-finance"},{slotId:"primaryStorage",connectionId:"conn-gcs-documents"},{slotId:"primaryOpenBanking",connectionId:"conn-powens-primary"},{slotId:"emailInbound",connectionId:"conn-gmail-threads"},{slotId:"emailOutbound",connectionId:"conn-postmark-outbound"},{slotId:"calendarScheduling",connectionId:"conn-google-calendar"},{slotId:"voicePlayback",connectionId:"conn-elevenlabs-voice"},{slotId:"smsNotifications",connectionId:"conn-twilio-sms"},{slotId:"paymentsProcessing",connectionId:"conn-stripe-recurring"}],knowledge:[{spaceKey:"knowledge.financial-docs",scope:{workflows:["pfo.workflow.process-uploaded-document","pfo.workflow.generate-financial-summary"]}},{spaceKey:"knowledge.email-threads",scope:{workflows:["pfo.workflow.ingest-email-threads"]}},{spaceKey:"knowledge.financial-overview",scope:{workflows:["pfo.workflow.sync-openbanking-transactions","pfo.workflow.refresh-openbanking-balances","pfo.workflow.generate-financial-summary","pfo.workflow.generate-openbanking-overview"]},required:!1}],locales:{defaultLocale:"en",enabledLocales:["en"]},notes:"Sample tenant configuration for hackathon demos. Replace connection IDs with tenant-specific bindings when provisioning."};export{n as pocketFamilyOfficeTenantSample};

package/dist/workflows/generate-financial-summary.d.ts

@@ -1 +1 @@
-export declare const generateFinancialSummaryWorkflow: import("@contractspec/lib.contracts-spec/workflow").WorkflowSpec;
+export declare const generateFinancialSummaryWorkflow: import("@contractspec/lib.contracts-spec/workflow/spec").WorkflowSpec;

package/dist/workflows/generate-financial-summary.js

@@ -1,59 +1,2 @@
 // @bun
-// src/workflows/generate-financial-summary.ts
-import {
-  OwnersEnum,
-  StabilityEnum,
-  TagsEnum
-} from "@contractspec/lib.contracts-spec";
-import { defineWorkflow } from "@contractspec/lib.contracts-spec/workflow";
-var generateFinancialSummaryWorkflow = defineWorkflow({
-  meta: {
-    key: "pfo.workflow.generate-financial-summary",
-    version: "1.0.0",
-    title: "Generate Financial Summary",
-    description: "Retrieves the latest financial signals, generates an AI summary, and optionally distributes it by voice or email.",
-    domain: "finance",
-    owners: [OwnersEnum.PlatformFinance],
-    tags: ["summary", "ai", TagsEnum.Automation],
-    stability: StabilityEnum.Beta
-  },
-  definition: {
-    entryStepId: "summarise",
-    steps: [
-      {
-        id: "summarise",
-        type: "automation",
-        label: "Generate Summary",
-        description: "Run retrieval augmented generation over the knowledge base to produce a household summary.",
-        action: {
-          operation: { key: "pfo.summary.generate", version: "1.0.0" }
-        },
-        requiredIntegrations: ["primaryLLM", "primaryVectorDb"],
-        retry: {
-          maxAttempts: 3,
-          backoff: "exponential",
-          delayMs: 750
-        }
-      },
-      {
-        id: "distribute",
-        type: "automation",
-        label: "Distribute Summary",
-        description: "Send the generated summary via email and optionally synthesise a voice note.",
-        action: {
-          operation: { key: "pfo.summary.dispatch", version: "1.0.0" }
-        },
-        requiredIntegrations: ["emailOutbound"],
-        retry: {
-          maxAttempts: 2,
-          backoff: "linear",
-          delayMs: 500
-        }
-      }
-    ],
-    transitions: [{ from: "summarise", to: "distribute" }]
-  }
-});
-export {
-  generateFinancialSummaryWorkflow
-};
+import{OwnersEnum as h,StabilityEnum as j,TagsEnum as q}from"@contractspec/lib.contracts-spec";import{defineWorkflow as v}from"@contractspec/lib.contracts-spec/workflow/spec";var A=v({meta:{key:"pfo.workflow.generate-financial-summary",version:"1.0.0",title:"Generate Financial Summary",description:"Retrieves the latest financial signals, generates an AI summary, and optionally distributes it by voice or email.",domain:"finance",owners:[h.PlatformFinance],tags:["summary","ai",q.Automation],stability:j.Beta},definition:{entryStepId:"summarise",steps:[{id:"summarise",type:"automation",label:"Generate Summary",description:"Run retrieval augmented generation over the knowledge base to produce a household summary.",action:{operation:{key:"pfo.summary.generate",version:"1.0.0"}},requiredIntegrations:["primaryLLM","primaryVectorDb"],retry:{maxAttempts:3,backoff:"exponential",delayMs:750}},{id:"distribute",type:"automation",label:"Distribute Summary",description:"Send the generated summary via email and optionally synthesise a voice note.",action:{operation:{key:"pfo.summary.dispatch",version:"1.0.0"}},requiredIntegrations:["emailOutbound"],retry:{maxAttempts:2,backoff:"linear",delayMs:500}}],transitions:[{from:"summarise",to:"distribute"}]}});export{A as generateFinancialSummaryWorkflow};

package/dist/workflows/generate-openbanking-overview.d.ts

@@ -1 +1 @@
-export declare const generateOpenBankingOverviewWorkflow: import("@contractspec/lib.contracts-spec/workflow").WorkflowSpec;
+export declare const generateOpenBankingOverviewWorkflow: import("@contractspec/lib.contracts-spec/workflow/spec").WorkflowSpec;

package/dist/workflows/generate-openbanking-overview.js

@@ -1,53 +1,2 @@
 // @bun
-// src/workflows/generate-openbanking-overview.ts
-import {
-  OwnersEnum,
-  StabilityEnum,
-  TagsEnum
-} from "@contractspec/lib.contracts-spec";
-import { defineWorkflow } from "@contractspec/lib.contracts-spec/workflow";
-var OPEN_BANKING_CAPABILITIES = [
-  { key: "openbanking.accounts.read", version: "1.0.0" },
-  { key: "openbanking.transactions.read", version: "1.0.0" },
-  { key: "openbanking.balances.read", version: "1.0.0" }
-];
-var generateOpenBankingOverviewWorkflow = defineWorkflow({
-  meta: {
-    key: "pfo.workflow.generate-openbanking-overview",
-    version: "1.0.0",
-    title: "Generate Open Banking Overview",
-    description: "Produces a derived financial overview and stores it in the operational knowledge space.",
-    domain: "finance",
-    owners: [OwnersEnum.PlatformFinance],
-    tags: ["open-banking", "summary", TagsEnum.Automation],
-    stability: StabilityEnum.Experimental
-  },
-  definition: {
-    entryStepId: "generate-overview",
-    steps: [
-      {
-        id: "generate-overview",
-        type: "automation",
-        label: "Generate Overview",
-        description: "Aggregate balances, cashflow, and category breakdowns into a knowledge entry.",
-        action: {
-          operation: {
-            key: "pfo.openbanking.generate-overview",
-            version: "1.0.0"
-          }
-        },
-        requiredIntegrations: ["primaryOpenBanking"],
-        requiredCapabilities: OPEN_BANKING_CAPABILITIES,
-        retry: {
-          maxAttempts: 3,
-          backoff: "exponential",
-          delayMs: 1500
-        }
-      }
-    ],
-    transitions: []
-  }
-});
-export {
-  generateOpenBankingOverviewWorkflow
-};
+import{OwnersEnum as h,StabilityEnum as j,TagsEnum as q}from"@contractspec/lib.contracts-spec";import{defineWorkflow as v}from"@contractspec/lib.contracts-spec/workflow/spec";var x=[{key:"openbanking.accounts.read",version:"1.0.0"},{key:"openbanking.transactions.read",version:"1.0.0"},{key:"openbanking.balances.read",version:"1.0.0"}],F=v({meta:{key:"pfo.workflow.generate-openbanking-overview",version:"1.0.0",title:"Generate Open Banking Overview",description:"Produces a derived financial overview and stores it in the operational knowledge space.",domain:"finance",owners:[h.PlatformFinance],tags:["open-banking","summary",q.Automation],stability:j.Experimental},definition:{entryStepId:"generate-overview",steps:[{id:"generate-overview",type:"automation",label:"Generate Overview",description:"Aggregate balances, cashflow, and category breakdowns into a knowledge entry.",action:{operation:{key:"pfo.openbanking.generate-overview",version:"1.0.0"}},requiredIntegrations:["primaryOpenBanking"],requiredCapabilities:x,retry:{maxAttempts:3,backoff:"exponential",delayMs:1500}}],transitions:[]}});export{F as generateOpenBankingOverviewWorkflow};