@agenticprimitives/home 0.0.0-alpha.1 → 0.0.0-alpha.4

package/dist/coordination.d.ts

@@ -0,0 +1,137 @@
+import type { CanonicalAgentId } from '@agenticprimitives/types';
+import type { VaultRef } from '@agenticprimitives/vault';
+import type { AuditRefV1 } from './types.js';
+import type { HomeActionDescriptorV1 } from './types.js';
+/** Endeavor lifecycle (spec 332 §5 `EndeavorV1.lifecycle`), projected as-is. */
+export type EndeavorLifecycle = 'proposed' | 'adopted' | 'active' | 'suspended' | 'satisfied' | 'abandoned';
+export declare const ENDEAVOR_LIFECYCLES: readonly EndeavorLifecycle[];
+/** Participation roles (spec 332 §3 `apcoord:role/*`) — ontology structure, never authority. */
+export type EndeavorParticipationRole = 'sponsor' | 'coordinator' | 'contributor' | 'validator' | 'beneficiary' | 'observer';
+/** The seven separate facts (ADR-0054 §4) a contribution entry may honestly
+ *  report. Projected, never collapsed: allocated ≠ committed ≠ performing. */
+export type ContributionStateFact = 'capable' | 'available' | 'allocated' | 'committed' | 'authorized' | 'performing' | 'satisfied';
+export declare const CONTRIBUTION_STATE_FACTS: readonly ContributionStateFact[];
+/** The exact plan revision a contribution binds to (spec 332 §5 `PlanRevisionRef`). */
+export interface HomePlanRevisionRefV1 {
+    planId: string;
+    revision: number;
+    /** Content hash of steps+edges+milestones — commitments bind to THIS, exactly. */
+    hash: string;
+}
+/** One Endeavor row for list/board/overview surfaces (spec 334 §8). */
+export interface HomeEndeavorSummaryV1 {
+    type: 'ap.home.endeavor-summary.v1';
+    endeavorId: string;
+    managingPrincipal: CanonicalAgentId;
+    title: string;
+    lifecycle: EndeavorLifecycle;
+    /** Outcome progress facts, projected honestly from `PlanStepSatisfied` events. */
+    stepsTotal: number;
+    stepsSatisfied: number;
+    /** The viewing principal's role, when they participate. */
+    viewerRole?: EndeavorParticipationRole;
+    deadline?: string;
+    updatedAt: string;
+}
+/** One allocation/commitment for THIS principal — the My Work row (spec 334 §7). */
+export interface HomeContributionEntryV1 {
+    type: 'ap.home.contribution-entry.v1';
+    endeavorId: string;
+    endeavorTitle: string;
+    managingPrincipal: CanonicalAgentId;
+    participant: CanonicalAgentId;
+    /** PlanSteps this entry covers. */
+    stepIds: string[];
+    /** The exact adopted plan revision the entry is scoped to. */
+    planRef: HomePlanRevisionRefV1;
+    status: ContributionStateFact;
+    allocationId?: string;
+    commitmentId?: string;
+    deadline?: string;
+    updatedAt: string;
+}
+/** A pending DecisionRequest for THIS approver — the render half; the
+ *  transport half is the interactions card (spec 334 §8, spec 333). Pressing
+ *  an action only PROPOSES a signed command — it grants nothing (spec 310 §6.3). */
+export interface HomeDecisionCardV1 {
+    type: 'ap.home.decision-card.v1';
+    decisionId: string;
+    endeavorId: string;
+    managingPrincipal: CanonicalAgentId;
+    /** The declared approver (spec 333 ApprovalRequirement) — steward status never substitutes. */
+    approver: CanonicalAgentId;
+    /** spec 333 decision kind (open vocabulary; app renders the label). */
+    decisionKind: string;
+    title: string;
+    summary?: string;
+    requestedAt: string;
+    dueAt?: string;
+    allowedActions: HomeActionDescriptorV1[];
+}
+/** Executing-run states, as A2A/fulfillment task states — projected, not owned. */
+export type AgentRunState = 'submitted' | 'working' | 'input-required' | 'completed' | 'failed' | 'canceled' | 'rejected';
+/** A Task/ServiceExecution bound to a commitment (spec 334 §8) — Agent Runs +
+ *  Endeavor detail rows. Bound by refs per the adapter provenance contract
+ *  (spec 332 §10), so the run trace joins the durable plan. */
+export interface HomeAgentRunEntryV1 {
+    type: 'ap.home.agent-run-entry.v1';
+    taskId: string;
+    endeavorId: string;
+    commitmentId: string;
+    stepId?: string;
+    state: AgentRunState;
+    /** Count of recorded checkpoints on the run. */
+    checkpoints: number;
+    artifactRefs: VaultRef[];
+    receiptRef?: string;
+    startedAt: string;
+    updatedAt: string;
+}
+/** An EndeavorCollection roll-up (spec 333) — Portfolio surface (later wave). */
+export interface HomePortfolioSummaryV1 {
+    type: 'ap.home.portfolio-summary.v1';
+    collectionId: string;
+    managingPrincipal: CanonicalAgentId;
+    title: string;
+    endeavorCount: number;
+    byLifecycle: Partial<Record<EndeavorLifecycle, number>>;
+    updatedAt: string;
+}
+/** The principal's offers/reservations vs active commitments (spec 333
+ *  resources) — Workload surface (later wave). Counts only; never authority. */
+export interface HomeCapacitySummaryV1 {
+    type: 'ap.home.capacity-summary.v1';
+    principal: CanonicalAgentId;
+    offersOpen: number;
+    reservations: number;
+    activeCommitments: number;
+    nextDeadline?: string;
+    updatedAt: string;
+}
+export type HomeCoordinationAlertKind = 'request-accepted' | 'request-declined' | 'request-answered' | 'step-blocked' | 'deadline-near' | 'decision-overdue';
+export declare const COORDINATION_ALERT_KINDS: readonly HomeCoordinationAlertKind[];
+/** A coordination notification for Messages + Activity (spec 334 §5/§8) —
+ *  backed by serving-plane audit rows; a display row, never a command. */
+export interface HomeCoordinationAlertV1 {
+    type: 'ap.home.coordination-alert.v1';
+    alertId: string;
+    alertKind: HomeCoordinationAlertKind;
+    /** The principal this alert is FOR. */
+    subject: CanonicalAgentId;
+    managingPrincipal: CanonicalAgentId;
+    endeavorId?: string;
+    requestId?: string;
+    title: string;
+    summary?: string;
+    at: string;
+    auditRef?: AuditRefV1;
+}
+export type EndeavorSummaryValidationError = 'bad_type' | 'missing_endeavor_id' | 'missing_managing_principal' | 'empty_title' | 'bad_lifecycle' | 'bad_step_counts' | 'bad_updated_at';
+export declare function validateHomeEndeavorSummary(s: HomeEndeavorSummaryV1): EndeavorSummaryValidationError[];
+export type ContributionEntryValidationError = 'bad_type' | 'missing_endeavor_id' | 'missing_participant' | 'no_steps' | 'bad_plan_ref' | 'bad_status' | 'committed_without_commitment_id';
+export declare function validateHomeContributionEntry(e: HomeContributionEntryV1): ContributionEntryValidationError[];
+export type DecisionCardValidationError = 'bad_type' | 'missing_decision_id' | 'missing_endeavor_id' | 'missing_approver' | 'empty_title' | 'no_actions' | 'duplicate_action_id';
+export declare function validateHomeDecisionCard(card: HomeDecisionCardV1): DecisionCardValidationError[];
+export type CoordinationAlertValidationError = 'bad_type' | 'missing_alert_id' | 'bad_alert_kind' | 'missing_subject' | 'empty_title' | 'bad_at';
+export declare function validateHomeCoordinationAlert(a: HomeCoordinationAlertV1): CoordinationAlertValidationError[];
+//# sourceMappingURL=coordination.d.ts.map

package/dist/coordination.d.ts.map

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

package/dist/coordination.js

@@ -0,0 +1,113 @@
+// Portable Home coordination projections (spec 334 §8) — the render-half
+// contracts a Home app projects over spec-332/333 coordination records and
+// audit rows. All seven are PROJECTIONS: none is a source of truth and none
+// carries authority (allocation ≠ commitment ≠ authorization — ADR-0054 §4;
+// the authority packages stay the only grant surface). No routes, UI,
+// storage, or branding here (ADR-0021).
+export const ENDEAVOR_LIFECYCLES = [
+    'proposed',
+    'adopted',
+    'active',
+    'suspended',
+    'satisfied',
+    'abandoned',
+];
+export const CONTRIBUTION_STATE_FACTS = [
+    'capable',
+    'available',
+    'allocated',
+    'committed',
+    'authorized',
+    'performing',
+    'satisfied',
+];
+export const COORDINATION_ALERT_KINDS = [
+    'request-accepted',
+    'request-declined',
+    'request-answered',
+    'step-blocked',
+    'deadline-near',
+    'decision-overdue',
+];
+// ─── Fail-closed structural validation (same discipline as validate.ts) ───
+const isIsoDate = (s) => typeof s === 'string' && !Number.isNaN(Date.parse(s));
+export function validateHomeEndeavorSummary(s) {
+    const errors = [];
+    if (s.type !== 'ap.home.endeavor-summary.v1')
+        errors.push('bad_type');
+    if (!s.endeavorId?.trim())
+        errors.push('missing_endeavor_id');
+    if (!s.managingPrincipal)
+        errors.push('missing_managing_principal');
+    if (!s.title?.trim())
+        errors.push('empty_title');
+    if (!ENDEAVOR_LIFECYCLES.includes(s.lifecycle))
+        errors.push('bad_lifecycle');
+    if (!Number.isInteger(s.stepsTotal) || !Number.isInteger(s.stepsSatisfied) ||
+        s.stepsTotal < 0 || s.stepsSatisfied < 0 || s.stepsSatisfied > s.stepsTotal) {
+        errors.push('bad_step_counts');
+    }
+    if (!isIsoDate(s.updatedAt))
+        errors.push('bad_updated_at');
+    return errors;
+}
+export function validateHomeContributionEntry(e) {
+    const errors = [];
+    if (e.type !== 'ap.home.contribution-entry.v1')
+        errors.push('bad_type');
+    if (!e.endeavorId?.trim())
+        errors.push('missing_endeavor_id');
+    if (!e.participant)
+        errors.push('missing_participant');
+    if (!Array.isArray(e.stepIds) || e.stepIds.length === 0)
+        errors.push('no_steps');
+    if (!e.planRef?.planId?.trim() || !e.planRef?.hash?.trim() || !Number.isInteger(e.planRef?.revision)) {
+        errors.push('bad_plan_ref');
+    }
+    if (!CONTRIBUTION_STATE_FACTS.includes(e.status))
+        errors.push('bad_status');
+    // A committed (or later) fact must carry the commitment it rests on — the
+    // seven facts stay separate; "committed" is never asserted without its record.
+    if ((e.status === 'committed' || e.status === 'performing' || e.status === 'satisfied') &&
+        !e.commitmentId?.trim()) {
+        errors.push('committed_without_commitment_id');
+    }
+    return errors;
+}
+export function validateHomeDecisionCard(card) {
+    const errors = [];
+    if (card.type !== 'ap.home.decision-card.v1')
+        errors.push('bad_type');
+    if (!card.decisionId?.trim())
+        errors.push('missing_decision_id');
+    if (!card.endeavorId?.trim())
+        errors.push('missing_endeavor_id');
+    if (!card.approver)
+        errors.push('missing_approver');
+    if (!card.title?.trim())
+        errors.push('empty_title');
+    if (!Array.isArray(card.allowedActions) || card.allowedActions.length === 0) {
+        errors.push('no_actions');
+    }
+    else if (new Set(card.allowedActions.map((a) => a.actionId)).size !== card.allowedActions.length) {
+        errors.push('duplicate_action_id');
+    }
+    return errors;
+}
+export function validateHomeCoordinationAlert(a) {
+    const errors = [];
+    if (a.type !== 'ap.home.coordination-alert.v1')
+        errors.push('bad_type');
+    if (!a.alertId?.trim())
+        errors.push('missing_alert_id');
+    if (!COORDINATION_ALERT_KINDS.includes(a.alertKind))
+        errors.push('bad_alert_kind');
+    if (!a.subject)
+        errors.push('missing_subject');
+    if (!a.title?.trim())
+        errors.push('empty_title');
+    if (!isIsoDate(a.at))
+        errors.push('bad_at');
+    return errors;
+}
+//# sourceMappingURL=coordination.js.map

package/dist/coordination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordination.js","sourceRoot":"","sources":["../src/coordination.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -4,4 +4,5 @@ export declare const SPEC_REF = "specs/310-agentic-trust-home-control-plane-and-
 export { type ProofRefV1, type PolicyRefV1, type AuditRefV1, type EndpointRefV1, type StoreRefV1, type AppRefV1, type HomeSurfaceKind, type HomeSurfaceDescriptorV1, type HomeEndpointSetV1, type HomeCapabilityCardV1, type HomeCryptoProfileDescriptorV1, type HomeInboxBindingV1, type HomeManifestV1, type HomeContextV1, type ManagedAgentEntryV1, type ConnectedAppGrantV1, type HomeCardUiProfile, type HomeActionCardKind, type HomeActionDescriptorV1, type HomeActionCardV1, type HomeControlEventV1, } from './types.js';
 export { type ManifestValidationError, validateHomeManifest, isManifestCurrent, type ManifestVerificationPort, type CardValidationError, validateHomeActionCard, resolveCardAction, } from './validate.js';
 export { type HomeInboxSummaryV1, projectHomeInboxSummary } from './projection.js';
+export { type EndeavorLifecycle, ENDEAVOR_LIFECYCLES, type EndeavorParticipationRole, type ContributionStateFact, CONTRIBUTION_STATE_FACTS, type HomePlanRevisionRefV1, type HomeEndeavorSummaryV1, type HomeContributionEntryV1, type HomeDecisionCardV1, type AgentRunState, type HomeAgentRunEntryV1, type HomePortfolioSummaryV1, type HomeCapacitySummaryV1, type HomeCoordinationAlertKind, COORDINATION_ALERT_KINDS, type HomeCoordinationAlertV1, type EndeavorSummaryValidationError, validateHomeEndeavorSummary, type ContributionEntryValidationError, validateHomeContributionEntry, type DecisionCardValidationError, validateHomeDecisionCard, type CoordinationAlertValidationError, validateHomeCoordinationAlert, } from './coordination.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,YAAY,4BAA4B,CAAC;AACtD,eAAO,MAAM,cAAc,EAAG,cAAuB,CAAC;AACtD,eAAO,MAAM,QAAQ,4DAA4D,CAAC;AAElF,OAAO,EACL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,6BAA6B,EAClC,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,uBAAuB,EAC5B,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,KAAK,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,YAAY,4BAA4B,CAAC;AACtD,eAAO,MAAM,cAAc,EAAG,cAAuB,CAAC;AACtD,eAAO,MAAM,QAAQ,4DAA4D,CAAC;AAElF,OAAO,EACL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,6BAA6B,EAClC,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,uBAAuB,EAC5B,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,KAAK,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAKnF,OAAO,EACL,KAAK,iBAAiB,EACtB,mBAAmB,EACnB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,wBAAwB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,2BAA2B,EAC3B,KAAK,gCAAgC,EACrC,6BAA6B,EAC7B,KAAK,2BAA2B,EAChC,wBAAwB,EACxB,KAAK,gCAAgC,EACrC,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -12,4 +12,8 @@ export const PACKAGE_STATUS = 'w1-contracts';
 export const SPEC_REF = 'specs/310-agentic-trust-home-control-plane-and-inbox.md';
 export { validateHomeManifest, isManifestCurrent, validateHomeActionCard, resolveCardAction, } from './validate.js';
 export { projectHomeInboxSummary } from './projection.js';
+// Coordination projections (spec 334 §8) — portable render contracts over the
+// spec-332/333 coordination records + audit rows. Projections only: none is a
+// source of truth and none carries authority.
+export { ENDEAVOR_LIFECYCLES, CONTRIBUTION_STATE_FACTS, COORDINATION_ALERT_KINDS, validateHomeEndeavorSummary, validateHomeContributionEntry, validateHomeDecisionCard, validateHomeCoordinationAlert, } from './coordination.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+EAA+E;AAC/E,mEAAmE;AACnE,4EAA4E;AAC5E,EAAE;AACF,uEAAuE;AACvE,+EAA+E;AAC/E,oEAAoE;AACpE,oEAAoE;AAEpE,MAAM,CAAC,MAAM,YAAY,GAAG,yBAAyB,CAAC;AACtD,MAAM,CAAC,MAAM,cAAc,GAAG,cAAuB,CAAC;AACtD,MAAM,CAAC,MAAM,QAAQ,GAAG,yDAAyD,CAAC;AA0BlF,OAAO,EAEL,oBAAoB,EACpB,iBAAiB,EAGjB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAA2B,uBAAuB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+EAA+E;AAC/E,mEAAmE;AACnE,4EAA4E;AAC5E,EAAE;AACF,uEAAuE;AACvE,+EAA+E;AAC/E,oEAAoE;AACpE,oEAAoE;AAEpE,MAAM,CAAC,MAAM,YAAY,GAAG,yBAAyB,CAAC;AACtD,MAAM,CAAC,MAAM,cAAc,GAAG,cAAuB,CAAC;AACtD,MAAM,CAAC,MAAM,QAAQ,GAAG,yDAAyD,CAAC;AA0BlF,OAAO,EAEL,oBAAoB,EACpB,iBAAiB,EAGjB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAA2B,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEnF,8EAA8E;AAC9E,8EAA8E;AAC9E,8CAA8C;AAC9C,OAAO,EAEL,mBAAmB,EAGnB,wBAAwB,EAUxB,wBAAwB,EAGxB,2BAA2B,EAE3B,6BAA6B,EAE7B,wBAAwB,EAExB,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticprimitives/home",
-  "version": "0.0.0-alpha.1",
+  "version": "0.0.0-alpha.4",
   "description": "Portable Agentic Trust Home contracts (spec 310): signed Home manifests, surface descriptors, inbox bindings, action cards, managed-agent/connected-app projections, control-plane events. Schema + validation + deterministic projection only — no routes, UI, or branding.",
   "license": "MIT",
   "repository": {
@@ -31,8 +31,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@agenticprimitives/fabric": "0.0.0-alpha.1",
-    "@agenticprimitives/types": "1.0.0-alpha.17",
+    "@agenticprimitives/fabric": "0.0.0-alpha.4",
+    "@agenticprimitives/types": "1.0.0-alpha.20",
     "@agenticprimitives/vault": "0.0.0-alpha.2"
   },
   "devDependencies": {