mirror of https://github.com/profullstack/logicsrc.git synced 2026-08-13 22:37:29 +00:00

feat(agentstack): add @logicsrc/agentstack coordination module (#5 )

* feat(agentstack): add @logicsrc/agentstack coordination module

AgentStack is the LogicSRC module for portable agent, task, payment, and
reputation coordination across Profullstack apps. Reference implementation of
the `agentstack` capability in the Profullstack Shared AppKit OpenSpec.

- packages/agentstack: DID helpers (did:coinpay:user/agent), DidTask model +
  lifecycle, AgentStack in-memory coordinator (agents, tasks, delegation,
  events), and a validated LogicSRC plugin definition. 9 vitest cases.
- Wire @logicsrc/agentstack into the root build chain (after plugin-core).
- docs/agentstack.md + mention in openspec-comparison.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs(agentstack): note dual-runtime support (Bun + Node.js + Workers + browser)

Matches the revised Shared AppKit PRD's Runtime Compatibility Strategy.
AgentStack is runtime-neutral (no Bun/Node-only APIs; time is injected).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-10 16:39:32 -07:00

2.9 KiB

Raw Blame History

AgentStack

Status: draft module

AgentStack (@logicsrc/agentstack) is the LogicSRC module for portable agent, task, payment, and reputation coordination across Profullstack microsaas apps. It is the reference implementation of the agentstack capability defined in the Profullstack Shared AppKit OpenSpec (profullstack-web/openspec/specs/agentstack).

Why

Profullstack apps (sh1pt, uGig, qaaas.dev, crawlproof, commandboard.run, coinpayportal, logicsrc, intr0s) need to share agents, tasks, reputation, and payment context without forcing a shared login or one global account database. AgentStack provides a small, provider-neutral coordination layer on top of CoinPay DIDs.

Identity model

User DID:   did:coinpay:user:123
Agent DID:  did:coinpay:agent:abc
Task:       task_123

Each app keeps a local users.id and links it to a CoinPay DID. The same person can appear in many apps while every app independently owns its account:

sh1pt.users.id      -> did:coinpay:user:123
ugig.users.id       -> did:coinpay:user:123
qaaas.users.id      -> did:coinpay:user:123
crawlproof.users.id -> did:coinpay:user:123

Task lifecycle

pending -> queued -> running -> blocked -> complete | failed | cancelled

A task may carry paymentIntentId, escrowId, and reputationEventId so coordination, payment, escrow, and reputation stay linked. Terminal statuses (complete, failed, cancelled) are final.

Surface

DID helpers: userDid, agentDid, makeDid, parseDid
DidTask, AgentProfile, DelegationGrant types
AgentStack coordinator: registerAgent, createTask, assignTask, updateTaskStatus, delegate, revokeDelegation, listTasks, snapshot, on
agentStackPlugin — a validated LogicSRC PluginDefinition

Runtime

Runtime-neutral by design — pure TypeScript, no Bun- or Node-only APIs (time is injected via the AgentStack constructor). Runs on Bun, Node.js, Cloudflare Workers, and the browser, matching the Profullstack dual-runtime standard (Bun + Node.js both first-class).

Plugin manifest

{
  "id": "agentstack",
  "name": "AgentStack",
  "type": ["agents", "tasks", "coordination"],
  "capabilities": [
    "agents.register", "agents.delegate",
    "tasks.create", "tasks.assign", "tasks.update", "tasks.publish",
    "reputation.sync", "payments.link", "escrow.link"
  ],
  "commands": ["agents", "tasks", "delegate"],
  "env": ["AGENTSTACK_API_URL", "AGENTSTACK_API_KEY", "COINPAY_API_BASE_URL"]
}

Relationship to other modules

CoinPay plugin — provides the DID/wallet/payment/escrow/reputation backend AgentStack references.
uGig plugin — publishes tasks to the jobs/gigs marketplace via tasks.publish.
AgentSwarm orchestration — higher-level multi-agent orchestration can consume AgentStack tasks and delegation grants.

See also openspec-comparison.md and the agentstack OpenSpec capability.

2.9 KiB Raw Blame History