agentos

Source#

• Repository: framerslab/agentos
• Last source update: 2026-06-06
• Last verified: 2026-06-07

Tags#

Integration notes#

Framework-level abstraction; derive bounded worker contracts from concrete tasks and APIs in docs/examples.

worker.md example#

Starter worker.md contract mapped from this registry entry. Copy this file and adapt schemas, constraints, and statuses for your task.

---
id: agentos-repo-derived-worker
name: agentos Repo-Derived Worker
version: 1.0.0
source_registry_url: https://worker.md/registry/agentos/
source_repository: https://github.com/framerslab/agentos
repository_default_branch: master
repository_language: TypeScript
repository_license: Apache-2.0
repository_updated_at: 2026-06-06
worker_mode: agent-orchestration-worker
derivation_method: github_repository_metadata_plus_raw_readme
derivation_confidence: 0.95
derived_on: 2026-06-07
tags:
  - agent-framework
  - agent-memory
  - agentic-ai
  - ai-agent-framework
  - ai-agents
  - autonomous-agents
---

# agentos Repo-Derived Worker

## Repo-derived summary
- Registry summary: TypeScript AI agent framework: cognitive memory, runtime tool forging, multi-agent orchestration, 11 LLM providers.
- Repository description: TypeScript AI agent framework: cognitive memory, runtime tool forging, multi-agent orchestration, 11 LLM providers.
- Stars (snapshot): 570
- Primary language: TypeScript
- Worker mode classification: agent-orchestration-worker

## Extracted from
- https://github.com/framerslab/agentos
- https://github.com/framerslab/agentos/blob/master/README.md
- https://img.shields.io/npm/v/@framers/agentos?style=flat-square&logo=npm&color=cb3837
- https://img.shields.io/github/actions/workflow/status/framerslab/agentos/ci.yml?branch=master&style=flat-square&logo=github&label=CI
- https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/framerslab/agentos/master/.github/badges/tests.json&style=flat-square&logo=vitest&logoColor=white

## Evidence notes (from repository text)
- README summary paragraph: **Agents that remember, forge their own tools, and survive long-running sessions.** Persistent cognitive memory, optional HEXACO personality, multi-agent orchestration, and one dispatch interface across 11 LLM providers. Apache-2.0.
- # **AgentOS** · TypeScript AI Agent Framework
- https://codecov.io/gh/framerslab/agentos/graph/badge.svg](https://codecov.io/gh/framerslab/agentos)
- AgentOS is an open-source TypeScript framework for AI agents that **remember, adapt, and write their own tools**.
- - **Runtime tool forging.** An agent writes a TypeScript function with a Zod schema, an LLM judge approves it, and it runs in a hardened `node:vm` sandbox before joining the catalog for the rest of the session.
- - **Persistent https://docs.agentos.sh/features/cognitive-memory** with 8 neuroscience-backed mechanisms: Ebbinghaus decay, retrieval-induced forgetting, reconsolidation, source-confidence decay.

## Installation hints found in README
- `npm install @framers/agentos`
- `npm install && pnpm build && pnpm test`

## worker.md contract (derived starter)
Purpose: Execute one orchestrated agent task as a bounded worker step.

### Input schema
```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "run_id",
    "task",
    "context"
  ],
  "properties": {
    "run_id": {
      "type": "string"
    },
    "task": {
      "type": "string"
    },
    "context": {
      "type": "object"
    }
  }
}
```

### Output schema
```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "run_id",
    "status",
    "result"
  ],
  "properties": {
    "run_id": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "ok",
        "retryable_error",
        "invalid_request",
        "invalid_output"
      ]
    },
    "result": {
      "type": "object"
    }
  }
}
```

### Constraints
- timeout_seconds: 30
- max_attempts: 2
- idempotency_key: run_id
- status_enum: [ok, retryable_error, invalid_request, invalid_output]
- notes: adapt to concrete APIs/classes documented in this repository before production use

## How this should be used
1. Treat this file as a repo-derived starter profile, not a claim of an official repository API contract.
2. Replace schemas with exact interfaces from code/docs you adopt.
3. Keep execution bounded and auditable using worker protocol constraints.

How to use#

• Save this as a worker spec file (for example: agentos-my-task.worker.md).
• Replace the input/output schemas and purpose with your real bounded task.
• Enforce schema validation + timeout + retry policy in your runtime before production use.

Citation#

Reference URL: https://worker.md/registry/agentos/

Source URL: https://github.com/framerslab/agentos