functions
Build and prove durable studio functions for record, order, schedule and tool events, with concurrent database updates and event feeds.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- functions
- description
- Build and prove durable studio functions for record, order, schedule and tool events, with concurrent database updates and event feeds.
03 SKILL.md 正文
Studio functions
Read the installed toolkit's functions/FUNCTIONS.md before implementing a handler.
Scaffold with homie-studio function new <name> --event <type>. Build and use
dev, then function fire <event> --id <stable-id> --input <JSON> at localhost.
Local function and tool calls use dev's private credential without browser approval;
live calls retain the studio's OAuth authorization. Include the app and booking
reference when proving fulfilment. Synthetic fire is local only.
Events are delivered at least once. Deduplicate external effects by event ID. Use
database.getVersioned with put(key,value,{version}) and retry conflicts for
read-modify-write; use atomic increment or append for those operations. Never
assume two deliveries cannot overlap. Prefix list returns cursor pages without
a studio-wide record cap. Apply migration 0024 through normal dev/deploy tooling.
Keep operational history in declared studio event feeds, not a growing JSON array.
Tools-only clients read studio_events_read; resource clients can subscribe.
Owner-requested studio_events_clear with a through-sequence removes retained
history and deliveries, including pending work. It does not delete app records.
Prove app needs on every named role and surface, using local check's default fresh isolated records. Assert actual sound/haptic/notification triggers where requested. Check waits through reload readiness and reports dialogs and named timeout conditions. Do not weaken a need to obtain a green result; inspect captures and complete the owner's workflow. Do not deploy merely to prove a local handler.
For authoritative bookings/inventory use strict defineTool actions and database.put(key, next, {version: row.version}); a conflict is a failed reservation. Never make the inventory a client-writable generic ledger. The capacity example proves one winner from six simultaneous requests for one place; initialise capacity through an owner-only action.
04 同仓库更多 Skills
worktable-review-with-annotations
Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.
worktable-find-and-synthesize-context
Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.
worktable-create-or-update-docs
Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.
worktable-create-or-manage-records
Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.
worktable-create-or-manage-interactive-html
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.
worktable-collaborate-threads
Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.