@recursiv/sdk 0.7.16 → 0.7.17

package/README.md

@@ -78,6 +78,7 @@ for await (const chunk of r.agents.chatStream(agent.id, { message: 'Hello!' }))
 | `r.brain` | `sendMessage` |
 | `r.commands` | `execute`, `gatePrompt` |
 | `r.projectBrain` | `tasks`, `decisions`, `milestones`, `completeTask`, `usage` |
+| `r.metrics` | `get`, `forOrg`, `forProject`, `children`, `definitions` — the KPI ledger per tier (platform, network, org, project): numbers with definitions, status, and confidence |
 
 ### Identity & Auth
 | Resource | Key methods |

package/dist/index.d.ts

@@ -41,6 +41,7 @@ import { DispatcherResource } from './resources/dispatcher.js';
 import { GoalsResource } from './resources/goals.js';
 import { HumanAsksResource } from './resources/human-asks.js';
 import { BriefResource } from './resources/brief.js';
+import { MetricsResource } from './resources/metrics.js';
 import { HumanInputResource } from './resources/human-input.js';
 import { SwarmsResource } from './resources/swarms.js';
 import { TemplatesResource } from './resources/templates.js';
@@ -101,6 +102,7 @@ export declare class Recursiv {
     readonly goals: GoalsResource;
     readonly humanAsks: HumanAsksResource;
     readonly brief: BriefResource;
+    readonly metrics: MetricsResource;
     readonly humanInput: HumanInputResource;
     readonly swarms: SwarmsResource;
     readonly templates: TemplatesResource;
@@ -158,6 +160,7 @@ export { EnvVarsResource } from './resources/env-vars.js';
 export type { QueryDatabaseInput, QueryResult } from './resources/databases.js';
 export { GitHubResource } from './resources/github.js';
 export { DeploymentsResource } from './resources/deployments.js';
+export type { PrepareProtocolServersInput, PreparedProtocolServers, ProtocolServerPreparation } from './resources/deployments.js';
 export { IntegrationsResource } from './resources/integrations.js';
 export type { ExecuteToolInput, ExecuteToolResult } from './resources/integrations.js';
 export { ProjectBrainResource } from './resources/project-brain.js';
@@ -186,7 +189,7 @@ export type { UploadMediaInput, UploadUrlInput, UploadUrlResult } from './resour
 export { WalletResource } from './resources/wallet.js';
 export { ProtocolsResource } from './resources/protocols.js';
 export { PROTOCOL_ADAPTER_MATURITIES, PROTOCOL_CAPABILITY_OPERATIONS, PROTOCOL_CAPABILITY_STATUSES, } from './resources/protocols.js';
-export type { ListProtocolCandidatesParams, ProtocolAdapterMaturity, ProtocolAdapterMetadata, ProtocolCandidateListResponse, ProtocolCandidatePageMeta, ProtocolCapabilityOperation, ProtocolCapabilityStatus, ProtocolCollectionStatus, ProtocolQuarantinedCandidate, ProtocolRefreshResult, ProtocolSettings, ProtocolSettingsUpdateResult, UpdateSettingsInput as UpdateProtocolSettingsInput, } from './resources/protocols.js';
+export type { HostedProtocolConnections, ListProtocolCandidatesParams, ProtocolAdapterMaturity, ProtocolAdapterMetadata, ProtocolCandidateListResponse, ProtocolCandidatePageMeta, ProtocolCapabilityOperation, ProtocolCapabilityStatus, ProtocolCollectionStatus, ProtocolQuarantinedCandidate, ProtocolRefreshResult, ProtocolSettings, ProtocolSettingsUpdateResult, UpdateSettingsInput as UpdateProtocolSettingsInput, } from './resources/protocols.js';
 export { InboxResource } from './resources/inbox.js';
 export { NetworkResource } from './resources/network.js';
 export { SimulatorResource } from './resources/simulator.js';
@@ -198,6 +201,8 @@ export { DispatcherResource } from './resources/dispatcher.js';
 export { GoalsResource } from './resources/goals.js';
 export { HumanAsksResource } from './resources/human-asks.js';
 export { BriefResource } from './resources/brief.js';
+export { MetricsResource } from './resources/metrics.js';
+export type { KpiTier, KpiStatus, KpiConfidence, KpiUnit, KpiNumber, KpiSeriesPoint, KpiRead, KpiChild, KpiChildren, KpiDefinition, KpiReadParams, KpiEvidence, EvidenceReceipt, EvidenceReceiptKind, EvidenceCompute, KpiPresence } from './resources/metrics.js';
 export type { Brief, BriefEmail, MyBrief, MyBriefEntry, BriefParams, BriefShipped, BriefNext, BriefStuckItem, BriefNumbers } from './resources/brief.js';
 export type { HumanAsk, HumanAskStatus, CreateHumanAskInput, ListHumanAsksParams } from './resources/human-asks.js';
 export { HumanInputResource } from './resources/human-input.js';
@@ -213,3 +218,4 @@ export { RecursivError, AuthenticationError, AuthorizationError, NotFoundError,
 export { parseSSE } from './lib/sse.js';
 export * from './lib/webhooks.js';
 export type * from './types.js';
+export type { PrepareHostedServiceInput, HostedServiceScope, HostedServiceOperation, HostedServiceReservation, HostedServiceObservation } from './resources/deployments.js';

package/dist/index.js

@@ -42,6 +42,7 @@ import { DispatcherResource } from './resources/dispatcher.js';
 import { GoalsResource } from './resources/goals.js';
 import { HumanAsksResource } from './resources/human-asks.js';
 import { BriefResource } from './resources/brief.js';
+import { MetricsResource } from './resources/metrics.js';
 import { HumanInputResource } from './resources/human-input.js';
 import { SwarmsResource } from './resources/swarms.js';
 import { TemplatesResource } from './resources/templates.js';
@@ -102,6 +103,7 @@ export class Recursiv {
     goals;
     humanAsks;
     brief;
+    metrics;
     humanInput;
     swarms;
     templates;
@@ -161,6 +163,7 @@ export class Recursiv {
         this.goals = new GoalsResource(client);
         this.humanAsks = new HumanAsksResource(client);
         this.brief = new BriefResource(client);
+        this.metrics = new MetricsResource(client);
         this.humanInput = new HumanInputResource(client);
         this.swarms = new SwarmsResource(client);
         this.templates = new TemplatesResource(client);
@@ -245,6 +248,7 @@ export { DispatcherResource } from './resources/dispatcher.js';
 export { GoalsResource } from './resources/goals.js';
 export { HumanAsksResource } from './resources/human-asks.js';
 export { BriefResource } from './resources/brief.js';
+export { MetricsResource } from './resources/metrics.js';
 export { HumanInputResource } from './resources/human-input.js';
 export { SwarmsResource } from './resources/swarms.js';
 export { TemplatesResource } from './resources/templates.js';

package/dist/resources/brief.d.ts

@@ -92,16 +92,31 @@ export interface BriefStuckItem {
 }
 export interface BriefMetricNumber {
     label: string;
-    value: number;
+    /** Null when the ledger could not count; `status` says so. */
+    value: number | null;
     unit: string;
     windowDays: number | null;
+    /** `ok` is a full count, `partial` a floor, `failed` no number. */
+    status?: 'ok' | 'partial' | 'failed';
+    /** ISO instant the number's windows end at. */
+    asOf?: string;
+    /** One sentence saying what the number counts. */
+    definition?: string;
+    definitionVersion?: number;
+    detail?: Record<string, unknown> | null;
 }
 export interface BriefNumbers {
     asOf: string;
+    /** The ledger day (YYYY-MM-DD) the numbers come from; null when there is none yet. */
+    bucket?: string | null;
+    /** True when the ledger missed a day: the numbers are older than yesterday. */
+    stale?: boolean;
+    /** The newest instant a recount agreed with the stored values, or null. */
+    verifiedAt?: string | null;
     source: 'platform' | 'postgres';
     querySetKey: string | null;
     numbers: Record<string, BriefMetricNumber>;
-    /** The weekly numbers as of `since`, when available. */
+    /** The same numbers seven days before `bucket`, for every source, when the ledger has them. */
     weekBefore: Record<string, number> | null;
 }
 export type BriefBlockName = 'shipped' | 'next' | 'stuck' | 'numbers';

package/dist/resources/deployments.d.ts

@@ -38,9 +38,106 @@ export interface GetLogsParams {
 export interface DeleteDeploymentParams {
     project_id: string;
 }
+export interface PrepareProtocolServersInput {
+    project_id: string;
+    network_id: string;
+    hosts: {
+        pds: string;
+        activitypub: string;
+        nostr: string;
+    };
+    /** Immutable upstream image references including @sha256 digest. */
+    images: {
+        pds: string;
+        activitypub: string;
+        nostr: string;
+    };
+    test_plc_url: string;
+    test_publisher_pubkeys: string[];
+}
+export interface PreparedProtocolServers {
+    id: string;
+    provider_service_uuid: string;
+    state: 'prepared';
+    runtime_status: 'unverified';
+}
+export interface ProtocolServerPreparation {
+    /** Provider process observation only; protocol interoperability remains unverified. */
+    provider_status: 'running' | 'stopped' | 'transitioning' | 'unhealthy' | 'unknown';
+    id: string;
+    provider_service_uuid: string | null;
+    service_name: string;
+    request_hash: string;
+    state: 'provisioning' | 'prepared' | 'starting' | 'uncertain';
+    updated_at: string;
+    runtime_status: 'unverified';
+}
+/** Server-maintained recipes; new service integrations extend this union. */
+export interface PrepareHostedServiceInput {
+    project_id: string;
+    network_id: string;
+    database_id: string;
+    recipe: 'plc-directory-v1';
+    hostname: string;
+}
+export interface HostedServiceScope {
+    project_id: string;
+    network_id: string;
+}
+export interface HostedServiceOperation extends HostedServiceScope {
+    request_hash: string;
+}
+export interface HostedServiceReservation {
+    id: string;
+    provider_service_uuid: string | null;
+    request_hash: string;
+    state: 'provisioning' | 'prepared' | 'starting' | 'uncertain';
+    /** Preparation and provider process state do not establish interoperability. */
+    runtime_status: 'unverified';
+}
+export interface HostedServiceObservation extends HostedServiceReservation {
+    provider_status: 'running' | 'stopped' | 'transitioning' | 'unhealthy' | 'unknown';
+}
 export declare class DeploymentsResource {
     private client;
     constructor(client: HttpClient);
+    /** Prepare a stopped staging service from a maintained recipe. Requires an unbound owner key. */
+    prepareHostedService(input: PrepareHostedServiceInput): Promise<SingleResponse<HostedServiceReservation>>;
+    getHostedService(scope: HostedServiceScope): Promise<SingleResponse<HostedServiceObservation | null>>;
+    /** Recover the existing stopped service without creating another service or rotating credentials. */
+    reconcileHostedService(input: HostedServiceOperation): Promise<SingleResponse<HostedServiceReservation>>;
+    /** Queue activation once; acceptance is not live health or interoperability proof. */
+    startHostedService(input: HostedServiceOperation): Promise<SingleResponse<HostedServiceReservation>>;
+    /** Reserve and prepare stopped staging servers. Requires an unbound platform operator key. */
+    prepareProtocolServers(input: PrepareProtocolServersInput): Promise<SingleResponse<PreparedProtocolServers>>;
+    /** Read operator-only reservation metadata. This does not probe runtime health. */
+    getProtocolServerPreparation(scope: {
+        project_id: string;
+        network_id: string;
+    }): Promise<SingleResponse<ProtocolServerPreparation>>;
+    /** Queue a single activation after verifying the saved provider configuration and secrets.
+     * A 202 response is not evidence of live runtime health. */
+    startProtocolServers(input: {
+        project_id: string;
+        network_id: string;
+        request_hash: string;
+    }): Promise<SingleResponse<{
+        id: string;
+        provider_service_uuid: string;
+        state: 'starting';
+        runtime_status: 'unverified';
+    }>>;
+    /** Reconcile an existing stopped reservation; never creates or starts a service. */
+    reconcileProtocolServers(input: {
+        project_id: string;
+        network_id: string;
+        request_hash: string;
+    }): Promise<SingleResponse<{
+        id: string;
+        provider_service_uuid: string;
+        state: 'prepared';
+        runtime_status: 'unverified';
+    }>>;
     /** List deployments for a project */
     list(params: ListDeploymentsParams): Promise<SingleResponse<unknown[]>>;
     /** Trigger a production deployment */

package/dist/resources/deployments.js

@@ -3,6 +3,38 @@ export class DeploymentsResource {
     constructor(client) {
         this.client = client;
     }
+    /** Prepare a stopped staging service from a maintained recipe. Requires an unbound owner key. */
+    prepareHostedService(input) {
+        return this.client.post('/deployments/hosted-services/prepare', input);
+    }
+    getHostedService(scope) {
+        return this.client.get('/deployments/hosted-services', { ...scope });
+    }
+    /** Recover the existing stopped service without creating another service or rotating credentials. */
+    reconcileHostedService(input) {
+        return this.client.post('/deployments/hosted-services/reconcile', input);
+    }
+    /** Queue activation once; acceptance is not live health or interoperability proof. */
+    startHostedService(input) {
+        return this.client.post('/deployments/hosted-services/start', input);
+    }
+    /** Reserve and prepare stopped staging servers. Requires an unbound platform operator key. */
+    prepareProtocolServers(input) {
+        return this.client.post('/deployments/protocol-servers/prepare', input);
+    }
+    /** Read operator-only reservation metadata. This does not probe runtime health. */
+    getProtocolServerPreparation(scope) {
+        return this.client.get('/deployments/protocol-servers', { project_id: scope.project_id, network_id: scope.network_id });
+    }
+    /** Queue a single activation after verifying the saved provider configuration and secrets.
+     * A 202 response is not evidence of live runtime health. */
+    startProtocolServers(input) {
+        return this.client.post('/deployments/protocol-servers/start', input);
+    }
+    /** Reconcile an existing stopped reservation; never creates or starts a service. */
+    reconcileProtocolServers(input) {
+        return this.client.post('/deployments/protocol-servers/reconcile', input);
+    }
     /** List deployments for a project */
     list(params) {
         return this.client.get('/deployments', { ...params });

package/dist/resources/metrics.d.ts

@@ -0,0 +1,169 @@
+import type { HttpClient } from '../client.js';
+import type { SingleResponse } from '../types.js';
+/** The platform's four tiers, top down. */
+export type KpiTier = 'platform' | 'network' | 'org' | 'project';
+export type KpiStatus = 'ok' | 'partial' | 'failed';
+/** One word for a whole read, worst case wins. */
+export type KpiConfidence = 'ok' | 'partial' | 'stale' | 'unverified' | 'missing';
+export type KpiUnit = 'count' | 'minor_units' | 'microcents' | 'basis_points';
+export interface KpiNumber {
+    key: string;
+    label: string;
+    /** Null when the ledger could not count; `status` says so. */
+    value: number | null;
+    unit: KpiUnit;
+    windowDays: number | null;
+    /** One sentence saying what the number counts. */
+    definition: string;
+    definitionVersion: number;
+    status: KpiStatus;
+    asOf: string | null;
+    bucket: string | null;
+    weekBefore: number | null;
+    delta: number | null;
+    verifiedAt: string | null;
+    source: 'platform' | 'postgres' | 'posthog' | null;
+    detail: Record<string, unknown> | null;
+}
+export interface KpiSeriesPoint {
+    bucket: string;
+    value: number | null;
+    status: KpiStatus;
+}
+export interface KpiRead {
+    tier: KpiTier;
+    scopeId: string;
+    asOf: string;
+    bucket: string | null;
+    stale: boolean;
+    verifiedAt: string | null;
+    confidence: KpiConfidence;
+    /** The three keys this tier leads with. */
+    headline: string[];
+    metrics: Record<string, KpiNumber>;
+    series?: Record<string, KpiSeriesPoint[]>;
+}
+export interface KpiChild {
+    tier: KpiTier;
+    scopeId: string;
+    name: string;
+    slug: string | null;
+    headline: {
+        key: string;
+        value: number | null;
+        status: KpiStatus | null;
+        bucket: string | null;
+    };
+}
+export interface KpiChildren {
+    tier: KpiTier;
+    scopeId: string;
+    childTier: KpiTier | null;
+    children: KpiChild[];
+}
+export type EvidenceReceiptKind = 'pull_request' | 'deploy' | 'task' | 'invoice' | 'stuck';
+export interface EvidenceReceipt {
+    kind: EvidenceReceiptKind;
+    title: string;
+    where: string | null;
+    at: string | null;
+    amountMinorUnits: number | null;
+    url: string | null;
+}
+export type EvidenceCompute = {
+    kind: 'sql';
+    sql: string;
+    params: unknown[];
+} | {
+    kind: 'resolver';
+    name: string;
+} | {
+    kind: 'external';
+    querySetKey: string;
+    sql: string | null;
+};
+/** The proof behind one number on one day. */
+export interface KpiEvidence {
+    tier: KpiTier;
+    scopeId: string;
+    metric: string;
+    label: string;
+    definition: string;
+    definitionVersion: number;
+    unit: string;
+    windowDays: number | null;
+    bucket: string | null;
+    snapshot: {
+        value: number | null;
+        status: KpiStatus;
+        detail: Record<string, unknown> | null;
+        asOf: string;
+        computedAt: string;
+        computeMs: number | null;
+        verifiedAt: string | null;
+        source: string;
+        definitionVersion: number;
+    } | null;
+    compute: EvidenceCompute | null;
+    window: {
+        since: string;
+        until: string;
+    } | null;
+    receipts: EvidenceReceipt[];
+    receiptsStatus: 'ok' | 'partial' | 'sql' | 'none';
+    receiptsDetail: Record<string, unknown> | null;
+}
+/** Who is here now: a five-minute pulse, never a KPI. */
+export interface KpiPresence {
+    tier: KpiTier;
+    scopeId: string;
+    /** Null when the presence store is not configured. */
+    activeNow: number | null;
+    /** Sixty per-minute counts, oldest first. */
+    minute: number[];
+    asOf: string;
+}
+export interface KpiDefinition {
+    tier: KpiTier;
+    key: string;
+    label: string;
+    unit: KpiUnit;
+    windowDays: number | null;
+    definition: string;
+    definitionVersion: number;
+    backfillable: boolean;
+}
+export interface KpiReadParams {
+    /** Subset of keys; every key of the tier when absent. */
+    keys?: string[];
+    /** ISO instant the windows end at. Default: now. */
+    asOf?: string;
+    /** Add daily series over this many days ending at asOf (1..400). */
+    seriesDays?: number;
+}
+/**
+ * The KPI ledger. Every number a person sees on a KPI screen, an agent
+ * reads here: the same rows, definitions, and confidence.
+ *
+ * Access follows the tier: platform owners, network admins, organization
+ * members, project admins or the owning organization.
+ */
+export declare class MetricsResource {
+    private client;
+    constructor(client: HttpClient);
+    private query;
+    /** One tier, one scope: every number with its definition, status, week-before, and one confidence word. */
+    get(tier: KpiTier, scopeId: string, params?: KpiReadParams): Promise<SingleResponse<KpiRead>>;
+    /** One organization's numbers. */
+    forOrg(organizationId: string, params?: KpiReadParams): Promise<SingleResponse<KpiRead>>;
+    /** One project's numbers. */
+    forProject(projectId: string, params?: KpiReadParams): Promise<SingleResponse<KpiRead>>;
+    /** The tier below, one row per child with its headline number. */
+    children(tier: KpiTier, scopeId: string): Promise<SingleResponse<KpiChildren>>;
+    /** The proof behind one number on one day: audit fields, the statement, the receipts. */
+    evidence(tier: KpiTier, scopeId: string, metric: string, day?: string): Promise<SingleResponse<KpiEvidence>>;
+    /** Who is here now. A pulse from the last five minutes, not a ledger number. */
+    presence(tier: KpiTier, scopeId: string): Promise<SingleResponse<KpiPresence>>;
+    /** Every definition, the words not the numbers. */
+    definitions(tier?: KpiTier): Promise<SingleResponse<KpiDefinition[]>>;
+}

package/dist/resources/metrics.js

@@ -0,0 +1,49 @@
+// ── Resource ──
+/**
+ * The KPI ledger. Every number a person sees on a KPI screen, an agent
+ * reads here: the same rows, definitions, and confidence.
+ *
+ * Access follows the tier: platform owners, network admins, organization
+ * members, project admins or the owning organization.
+ */
+export class MetricsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    query(params) {
+        return {
+            ...(params.keys?.length ? { keys: params.keys.join(',') } : {}),
+            ...(params.asOf ? { as_of: params.asOf } : {}),
+            ...(params.seriesDays ? { series_days: params.seriesDays } : {}),
+        };
+    }
+    /** One tier, one scope: every number with its definition, status, week-before, and one confidence word. */
+    async get(tier, scopeId, params = {}) {
+        return this.client.get('/metrics', { tier, scope_id: scopeId, ...this.query(params) });
+    }
+    /** One organization's numbers. */
+    async forOrg(organizationId, params = {}) {
+        return this.client.get(`/organizations/${organizationId}/metrics`, this.query(params));
+    }
+    /** One project's numbers. */
+    async forProject(projectId, params = {}) {
+        return this.client.get(`/projects/${projectId}/metrics`, this.query(params));
+    }
+    /** The tier below, one row per child with its headline number. */
+    async children(tier, scopeId) {
+        return this.client.get('/metrics/children', { tier, scope_id: scopeId });
+    }
+    /** The proof behind one number on one day: audit fields, the statement, the receipts. */
+    async evidence(tier, scopeId, metric, day) {
+        return this.client.get('/metrics/evidence', { tier, scope_id: scopeId, metric, ...(day ? { day } : {}) });
+    }
+    /** Who is here now. A pulse from the last five minutes, not a ledger number. */
+    async presence(tier, scopeId) {
+        return this.client.get('/metrics/presence', { tier, scope_id: scopeId });
+    }
+    /** Every definition, the words not the numbers. */
+    async definitions(tier) {
+        return this.client.get('/metrics/definitions', tier ? { tier } : undefined);
+    }
+}

package/dist/resources/protocols.d.ts

@@ -121,11 +121,21 @@ export interface ProtocolSettingsUpdateResult {
     success: true;
     protocol_settings: Omit<ProtocolSettings, 'available_protocols'>;
 }
+export interface HostedProtocolConnections {
+    state: 'not_configured' | 'provisioning' | 'prepared' | 'starting' | 'uncertain';
+    interoperability: 'unverified';
+    servers: {
+        protocol: 'atproto' | 'activitypub' | 'nostr';
+        url: string;
+    }[];
+}
 export declare class ProtocolsResource {
     private client;
     constructor(client: HttpClient);
     /** List adapters with truthful capability, maturity, and limitation metadata. */
     list(): Promise<SingleResponse<ProtocolAdapterMetadata[]>>;
+    /** Configured addresses for the current app. Does not attest runtime or account readiness. */
+    hostedServers(): Promise<SingleResponse<HostedProtocolConnections>>;
     /** Get project-scoped unpublished candidate status (admin) */
     status(): Promise<SingleResponse<ProtocolCollectionStatus[]>>;
     /**

package/dist/resources/protocols.js

@@ -37,6 +37,10 @@ export class ProtocolsResource {
     list() {
         return this.client.get('/protocols');
     }
+    /** Configured addresses for the current app. Does not attest runtime or account readiness. */
+    hostedServers() {
+        return this.client.get('/protocols/servers');
+    }
     /** Get project-scoped unpublished candidate status (admin) */
     status() {
         return this.client.get('/protocols/status');

package/llm.md

@@ -652,6 +652,27 @@ await r.dispatcher.deleteWebhook(id)
 
 ---
 
+## KPIs (the metric ledger)
+
+Every KPI a person sees, an agent reads from the same daily snapshots. Numbers carry a one-sentence definition, a status (`ok`, `partial`, `failed`), the value seven days earlier, and one `confidence` word for the whole read. A number that could not be counted is `null`, never `0`.
+
+```typescript
+// One tier, one scope. Access follows the tier: platform owners, network admins,
+// organization members, project admins or the owning organization.
+const { data } = await r.metrics.forOrg(orgId, { keys: ['activeIn28Days', 'revenueIn28Days'], seriesDays: 28 });
+data.confidence;                       // 'ok' | 'partial' | 'stale' | 'unverified' | 'missing'
+data.metrics.activeIn28Days.value;     // 312
+data.metrics.activeIn28Days.weekBefore; // 288
+data.metrics.activeIn28Days.definition; // 'Distinct product users who opened an app ... ending at as_of.'
+
+await r.metrics.forProject(projectId);             // members, signups, active, posts, API health
+await r.metrics.get('network', networkId);         // admins: users, retention, MRR, waitlist
+await r.metrics.children('org', orgId);            // the org's projects with their headline number
+await r.metrics.definitions('project');            // every key with its sentence, for a success metric
+```
+
+A task's `success_metric` can name a ledger key: `internal.project.activeIn7Days > 100`.
+
 ## Golden paths
 
 ### AI-native app (database + agent + storage + auth)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recursiv/sdk",
-  "version": "0.7.16",
+  "version": "0.7.17",
   "description": "TypeScript SDK for the Recursiv API",
   "license": "FSL-1.1-ALv2",
   "type": "module",